This Page Is Inserted by IFW Operations 
and is -not a part of the Officjia] Record 

BEST AVAILABLE IMAGES 



Defective images within this document are accurate representations o 
the original documents submitted by the applicant. 

Defects in the images may include (but are not limited to): 

• BLACK BORDERS 

• TEXT CUT OFF AT TOP, BOTTOM OR SIDES 

• FADED TEXT 

• ILLEGIBLE TEXT 

• SKEWED/SLANTED IMAGES 

• COLORED PHOTOS 

• BLACK OR VERY BLACK AND WHITE DARK PHOTOS 

• GRAY SCALE DOCUMENTS 



IMAGES ARE BEST AVAILABLE COPY. 

As rescanning documents will not correct images, 
please do not report the images to the 
Image Problem Mailbox. 



this Page aanK luspto) 



PCT 



WORLD INTELLECTUAL PROPERTY ORGANIZATION 
International Bureau 




(51) International Patent Classification 6 : 




(11) International Publication Number: 


WO 98/37675 


H04L 29/06, G07F 7/10, G06F 1/00 


Al 


(43) International Publication Date: 


27 August 1998 (27.08.98) 



(21) International Application Number: PCT/US98/03236 

(22) International Filing Date: 18 February 1998 (18.02.98) 



(30) Priority Data: 
08/801,026 



19 February 1997 (19.02.97) US 



(71) Applicant (for all designated States except US): VERIFONE, 
INC. [US/US]; 4988 Great America Parkway, Santa Clara, 
CA 95054-1200 (US). 

(72) Inventor; and 

(75) Inventor/Applicant (for US only): ROWNEY, Kevin, T., B. 
[US/US]; 748 Duncan Street, San Francisco, CA 94131 
(US). 

(74) Agents: WARREN, Sanford, E., Jr. et al.; Warren & Perez, 
Suite 710, 8411 Preston Road, Dallas, TX 75225 (US). 



(81) Designated States: AL, AM, AT, AU, AZ, BA, BB, BG, BR, 
BY, CA, CH, CN, CU, CZ, DE, DK, EE, ES, FI, GB, GE, 
GH, GM, GW, HU, ID, IL, IS, JP, KE, KG, KP, KR, KZ, 
LC, LK, LR, LS, LT, LU, LV, MD, MG, MK, MN, MW, 
MX, NO, NZ, PL, PT, RO, RU, SD, SE, SG, SI, SK, SL, 
TJ, TM, TR, TT, UA, UG, US, UZ, VN, YU, ZW, ARIPO 
patent (GH, GM, KE, LS, MW, SD, SZ, UG, ZW), Eurasian 
patent (AM, AZ, BY, KG, KZ, MD, RU, TJ, TM), European 
patent (AT, BE, CH, DE, DK, ES, FI, FR, GB, GR, IE, IT, 
LU, MC, NL, PT, SE), OAPI patent (BF, BJ, CF, CG, CI, 
CM, GA, GN, ML, MR, NE, SN, TD, TG). 



Published 

With international search report. 

Before the expiration of the time limit for amending the 
claims and to be republished in the event of the receipt of 
amendments. 



(54) Title: A SYSTEM, METHOD AND ARTICLE OF MANUFACTURE FOR SECURE DIGITAL CERTIFICATION OF ELEC- 
TRONIC COMMERCE 



CUSTOMER 




150 



MERCHANT 



PAYMENT 
GATEWAY 




170 ■ 
I 1J0 




(57) Abstract 

Secure transmission of data is provided between a plurality of computer systems ( 1 20, 1 30, 1 40) over a public communication system 
(150 170) such as the Internet. Secure transmission of data is provided from a party in communication with a first application resident on 
a first computer (130) which is in communication with a second computer with a certification authority application resident thereon. The 
second computer (140) is in communication with a third computer utilizing an administrative function resident thereon. The first (130), 
second and third (140) computers are connected by a network (150, 170), such as the Internet. A name-value pair for certification processing 
is created on said first computer (130) and transmitted to an administrative function on the third computer (140). Then, the name-value 
pair is routed to the appropriate certification authority on the second computer. The administrative function also transmits other cerfication 
information from said admistrative function to said certification authority on the second computer. Until, finally, a certificate is created 
comprising the nain^value paiFandlhe otheFcertificali6n"information on the second computer. The'certificate is utilized for authenticating 
indentity of the party. 



FOR THE PURPOSES OF INFORMATION ONLY 



Codes used to identify States party to the PCT on the front pages of pamphlets publishing international applications under the PCT. 



AL 


Albania 


ES 


Spain 


LS 


Lesotho 


SI 


Slovenia 


AM 


Armenia 


FI 


Finland 


LT 


Lithuania 


SK 


Slovakia 


AT 


Austria 


FR 


France 


LU 


Luxembourg 


SN 


Senegal 


AU 


Australia 


GA 


Gabon 


LV 


Latvia 


sz 


Swaziland 


AZ 


Azerbaijan 


GB 


United Kingdom 


MC 


Monaco 


TD 


Chad 


BA 


Bosnia and Herzegovina 


GE 


Georgia 


MD 


Republic of Moldova 


TG 


Togo 


BB 


Barbados 


GH 


Ghana 


MG 


Madagascar 


TJ 


Tajikistan 


BE 


Belgium 


GN 


Guinea 


MK 


The former Yugoslav 


TM 


Turkmenistan 


BF 


Burkina Paso 


GR 


Greece 




Republic of Macedonia 


TR 


Turkey 


BG 


Bulgaria 


HU 


Hungary 


ML 


Mali 


TT 
UA 


Trinidad and Tobago 


BJ 


Benin 


IE 


Ireland 


MN 


Mongolia 


Ukraine 


BR 


Brazil 


IL 


Israel 


MR 


Mauritania 


UG 


Uganda 


BY 


Belarus 


IS 


Iceland 


MW 


Malawi 


US 


United States of America 


CA ... 


.Canada. 


_ IT 


Italy 


MX 


Mexico 


UZ 


Uzbekistan 


CF 


Central African Republic 


JP 


Japan 


NE 


Niger 


VN ~ 


Viet "Nam 


CG 


Congo 


KE 


Kenya 


NL 


Netherlands 


YU 


Yugoslavia 


CH 


Switzerland 


KG 


Kyrgyzstan 


NO 


Norway 


ZW 


Zimbabwe 


CI 


Cflte d*Ivoire 


KP 


Democratic People's 


NZ 


New Zealand 






CM 


Cameroon 




Republic of Korea 


PL 


Poland 






CN 


China 


KR 


Republic of Korea 


PT 


Portugal 






CU 


Cuba 


KZ 


Kazakstan 


RO 


Romania 






CZ 


Czech Republic 


LC 


Saint Lucia 


RU 


Russian Federation 






DB 


Germany 


LI 


Liechtenstein 


SD 


Sudan 






DK 


Denmark 


LK 


Sri Lanka 


SE 


Sweden 






EE 


Estonia 


LR 


Liberia 


SG 


Singapore 







WO 98/37675 



PCT/US98/03236 



A SYSTEM, METHOD AND ARTICLE OP MANUFACTURE FOR 
SECURE DIGITAL CERTIFICATION OF ELECTRONIC COMMERCE 

Field Of The Invention 

5 The present invention relates to the secure, electronic payment in exchange 
for goods and services purchased over a communication network, and more 
specifically, to a system, method and article of manufacture for securely 
transmitting payment information from a customer to a merchant to a 
payment gateway and returning a certification, including a credit confidence 

10 factor to allow a merchant to determine whether to accept or reject payment 
information utilizing a flexible, extensible architecture. 

The present invention relates to an electronic graphical representation of a 
monetary system for implementing electronic money payments as an 

15 alternative medium of economic exchange to cash, checks, credit and debit 
cards, and electronic funds transfer. The Electronic-Monetary System is a 
hybrid of currency, check, card payment systems, and electronic funds 
transfer systems, possessing many of the benefits of these systems with few 
of their limitations. The system utilizes electronic representations of money 

20 which are designed to be universally accepted and exchanged as economic 
value by subscribers of the monetary system. 

Today, approximately 350 billion coin and currency transactions occur 
between individuals and institutions every year. The extensive use of coin 
25 and currency 

transactions has limited the automation of individual transactions such as 
purchases, fares, and bank account deposits and withdrawals. Individual_ 
cash transactions are burdened by the need to have the correct amount of 

[ 
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cash or providing change therefor. Furthermore, the handling and managing 
of paper cash and coins is inconvenient, costly and time consuming for both 
individuals and financial institutions. 

5 Although checks may be written for any specific amount up to the amount 
available in the account, checks have very limited transferability and must 
be supplied from a physical inventory. Paper-based checking systems do 
not offer sufficient relief from the limitations of cash transactions, sharing 
many of the inconveniences of handling currency while adding the inherent 

10 delays associated with processing checks. To this end, economic exchange 
has striven for greater convenience at a lower cost, while also seeking 
improved security. 

Automation has achieved some of these qualities for large transactions 
15 through computerized electronic funds transfer ("EFT") systems. Electronic 
funds transfer is essentially a process of value exchange achieved through 
the banking system's centralized computer transactions. EFT services are a 
transfer of payments utilizing electronic "checks," which are used primarily 
by large commercial organizations. 

20 

The Clearing House (ACH) where a user can enter a pre-authorized code and 
download information with billing occurring later, and a Point Of Sale (POS) 
system where a transaction is processed by connecting with a central 
computer for authorization for the transaction granted or denied 
25 immediately are examples of EFT systems that are utilized by retail and 

commercial organizations. However, the payments made through these types 
of EFT systems are limited in that they cannot be performed without the 
banking s yst em. Moreover, ACH transactions usually cannot be performed 
during off business hours. 

> 
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Home Banking bill payment services are examples of an EFT system used by 
individuals to make payments from a home computer. Currently, home 
banking initiatives have found few customers. Of the banks that have 
5 offered services for payments, account transfers and information over the 
telephone lines using personal computers, less than one percent of the 
bank's customers are using the service. One reason that Home Banking has 
not been a successful product is because the customer cannot deposit and 
withdraw money as needed in this type of system. 

10 

Current EFT systems, credit cards, or debit cards, which are used in 
conjunction with an on-line system to transfer money between accounts, 
such as between the account of a merchant and that of a customer, cannot 
satisfy the need for an automated transaction system providing an 
15 ergonomic interface. Examples of EFT systems which provide non- 
ergonomic interfaces are disclosed in US Patents Numbers 5,476,259; 
5,459,304; 5,452,352; 5,448,045; 5,478,993; 5,455,407; 5,453,601; 
5,465,291; and 5,485,510. 

20 To implement an automated, convenient transaction that can dispense some 
form of economic value, there has been a trend towards off-line payments. 
For example, numerous ideas have been proposed for some form of 
"electronic money" that can be used in cashless payment transactions as 
alternatives to the traditional currency and check types of payment systems. 

25 See U.S. Pat. No. 4,977,595, entitled "METHOD AND APPARATUS FOR 

IMPLEMENTING ELECTRONIC CASH," and U.S. Pat. No. 4,305,059, entitled 
"MODULAR FUNDS TRANSFER SYSTEM." 



3 
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The more well known techniques include magnetic stripe cards purchased 
for a given amount and from which a prepaid value can be deducted for 
specific purposes. Upon exhaustion of the economic value, the cards are 
thrown away. Other examples include memory cards or so called smart 
5 cards which are capable of repetitively storing information representing 
value that is likewise deducted for specific purposes. 

It is desirable for a computer operated under the control of a merchant to 
obtain information offered by a customer and transmitted by a computer 
operating under the control of the customer over a publicly accessible 
packet-switched network (e.g., the Internet) to the computer operating under 
the control of the merchant, without risking the exposure of the information 
to interception by third parties that have access to the network, and to 
assure that the information is from an authentic source. It is further 
desirable for the merchant to transmit information, including a subset of the 
information provided by the customer, over such a network to a payment 
gateway computer system that is authorized, by a bank or other financial 
institution that has the responsibility of providing payment on behalf of the 
customer, to authorize a commercial transaction on behalf of such a 
financial institution, without the risk of exposing that information to 
interception by third parties. Such institutions include, for example, 
financial institutions offering credit or debit card services. 

One such attempt to provide such a secure transmission channel is a secure 
25 payment technology such as Secure Electronic Transaction (hereinafter 

"SET"), jointly developed by the Visa and MasterCard card associations, and 
described in Visa and MasterCard's Secure Electronic Transaction (SET) 
Specification, February 23, 1996, hereby incorporated by reference. Other _ 
such secure payment technologies include Secure Transaction Technology 

H 
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("STT"), Secure Electronic Payments Protocol ("SEPP"), Internet Keyed 
Payments ("iKP"), Net Trust, and Cybercash Credit Payment Protocol. One of 
ordinary skill in the art readily comprehends that any of the secure payment 
technologies can be substituted for the SET protocol without undue 

5 experimentation. Such secure payment technologies require the customer 
to operate software that is compliant with the secure payment technology, 
interacting with third-party certification authorities, thereby allowing the 
customer to transmit encoded information to a merchant, some of which 
may be decoded by the merchant, and some which can be decoded only by a 

10 payment gateway specified by the customer. 

Another such attempt to provide such a secure transmission channel is a 
general-purpose secure communication protocol such as Netscape, Inc.'s 
Secure Sockets Layer (hereinafter "SSL") , as described in Freier, Karlton 85 

15 Kocher (hereinafter "Freier"), The SSL Protocol Version 3.0, March 1996, and 
hereby incorporated by reference. SSL provides a means for secure 
transmission between two computers. SSL has the advantage that it does 
not require special-purpose software to be installed on the customer's 
computer because it is already incorporated into widely available software 

20 that many people utilize as their standard Internet access medium, and does 
not require that the customer interact with any third-party certification 
authority. Instead, the support for SSL may be incorporated into software 
already in use by the customer, e.g., the Netscape Navigator World Wide 
Web browsing tool. However, although a computer on an SSL connection 

25 may initiate a second SSL connection to another computer, a drawback to 
the SSL approach is each SSL connection supports only a two-computer 
connection. Therefore, SSL does not provide a mechanism for transmitting 
encoded information to a merchant for retransmission to ^payment gateway 
such that a subset of the information is readable to the payment gateway 

S 
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but not to the merchant. Although SSL allows for robustly secure two-party 
data transmission, it does not meet the ultimate need of the electronic 
commerce market for robustly secure three-party data transmission. Other 
examples of general-purpose secure communication protocols include 

5 Private Communications Technology ("PCT") from Microsoft, Inc., Secure 
Hyper-Text Transport Protocol ("SHTTP") from Theresa Systems, Shen, 
Kerberos, Photuris, Pretty Good Privacy ("PGP") and Ipv6 which meets the 
IPSEC criteria. One of ordinary skill in the art readily comprehends that any 
of the general-purpose secure communication protocols can be substituted 

10 for the SSL transmission protocol without undue experimentation. 

Banks desire an internet payment solution that emulates existing Point of 
Sale (POS) applications that are currently installed on their host computers, 
and require minimal changes to their host systems. This is a critical 

15 requirement since any downtime for a banks host computer system 
represents an enormous expense. Currently, Verifone supports over 
fourteen hundred different payment-related applications. The large number 
of applications is necessary to accommodate a wide variety of host message 
formats, diverse methods for communicating to a variety of hosts with 

20 different dial-up and direct-connect schemes, and different certification 
around the world. In addition, there are a wide variety of business 
processes that dictate how a Point of Sale (POS) terminal queries a user for 
data and subsequently displays the data. Also, various vertical market 
segments, such as hotels, car rental agencies, restaurants, retail sales, mail 

25 sales / telephone sales require interfaces for different types of data to be 
entered, and provide different discount rates to merchants for complying 
with various data types. Moreover, a plethora of report generation 
mechanisms and formats.are utilized by: merchants that banking 
organizations work with. 
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Banks are unwilling to converge on "standards" since convergence would 
facilitate switching from one acquiring bank to another by merchants. In 
general, banks desire to increase the cost that a merchant incurs in 
5 switching from one acquiring bank to another acquiring bank. This is 
accomplished by supplying a merchant with a terminal that only 
communicates utilizing the bank's proprietary protocol, and by providing 
other value-added services that a merchant may not be able to obtain at 
another bank. 

10 

Internet-based payment solutions require additional security measures that 
are not found in conventional POS terminals. This additional requirement is 
necessitated because internet communication is done over publicly- 
accessible, unsecured communication line in stark contrast to the private, 
15 secure, dedicated phone or leased line service utilized between a traditional 
merchant and an acquiring bank. Thus, it is critical that any solution 
utilizing the internet for a communication backbone, employ some form of 
cryptography. 

20 As discussed above, the current state-of-the-art in internet based payment 
processing is a protocol referred to as SET. Since the SET messages are 
uniform across all implementations, banks cannot differentiate themselves 
in any reasonable way. Also, since SET is not a proper superset of all 
protocols utilized today, there are bank protocols which cannot be mapped 

25 or translated into SET because they require data elements for which SET 

has no placeholder. Further, SET only handles the message types directly - 

related to authorizing and capturing credit card transactions and 
adjustments to these auj^orizations or captures. In a typical POS terminal 
in the physical world, these messages comprise almost the entire volume of 

"7 
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the total number of messages between the merchant and the authorizing 
bank, but only half of the total number of different message types. These 
message types, which are used infrequently, but which are critical to the 
operation of the POS terminal must be supported for proper transaction 
5 processing. 

SUMMARY OF THE INVENTION 

According to a broad aspect of a preferred embodiment of the invention, 
secure transmission of data is provided between a plurality of computer 

10 systems over a public communication system, such as the Internet. Secure 
transmission of data is provided from a party in communication with a first 
application resident on a first computer which is in communication with a 
second computer with a certification authority application resident thereon. 
The second computer is in communication with a third computer utilizing an 

15 administrative function resident thereon. The first, second and third computers 
are connected by a network, such as the Internet. A name-value pair for 
certification processing is created on said first computer and transmitted to an 
administrative function on the third computer. Then, the name-value pair is 
routed to the appropriate certification authority on the second computer. The 

20 administrative function also transmits other certification information from said 
administrative function to said certification authority on the second computer. 
Until, finally, a certificate is created comprising the name-value pair and the 
other certification information on the second computer. 

25 DESCRIPTION OP THE DRAWINGS 

The foregoing and other objects, aspects and advantages are better 
understood from the following detailed description of a preferred 
embodiment of the invention with reference to the drawings, in which: 
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Figure 1A is a block diagram of a representative hardware environment in 
accordance with a preferred embodiment; 

Figure IB depictaan overview in accordance with a preferred embodiment; 

Figure 1C is a block diagram of the system in accordance with a preferred 
embodiment; 

Figure 2 depicts a more detailed view of a customer computer system in 
communication with merchant system under the Secure Sockets Layer 
protocol in accordance with a preferred embodiment; 

Figure 3 depicts an overview of the method of securely supplying payment 
information to a payment gateway in order to obtain payment authorization 
in accordance with a preferred embodiment; 

Figure 4 depicts the detailed steps of generating and transmitting a payment 
authorization request in accordance with a preferred embodiment; 

Figures 5A through 5F depict views of the payment authorization request 
and its component parts in accordance with a preferred embodiment; 

Figures 6A and 6B depict the detailed steps of processing a payment 
authorization request and generating and transmitting a payment 
authorization request response in accordance with a preferred embodiment; 

Figures 7 A through 7 J depict views of the payment authorization response 
and its component parts in accordance with a preferred embodiment; 
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Figure 8 depicts the detailed steps of processing a payment authorization 
response in accordance with a preferred embodiment; 

Figure 9 depicts an overview of the method of securely supplying payment 
5 capture information to a payment gateway in accordance with a preferred 
embodiment; 

Figure 10 depicts the detailed steps of generating and transmitting a 
payment capture request in accordance with a preferred embodiment; 

10 

Figures 11A through 11F depict views of the payment capture request and 
its component parts in accordance with a preferred embodiment; 

Figures 12A and 12B depict the detailed steps of processing a payment 
15 capture request and generating and transmitting a payment capture request 
response in accordance with a preferred embodiment; 

Figures 13A through 13F depict views of the payment capture response and 
its component parts in accordance with a preferred embodiment; 

20 

Figure 14 depicts the detailed steps of processing a payment capture 
response in accordance with a preferred embodiment; 

Figure ISA & 15B depicts transaction processing of merchant and 
25 consumer transactions in accordance with a preferred embodiment; 

Figure 16 illustrates a transaction class hierarchy block diagram in 
accordance with a preferred embodiment; _ _ _ _ 
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Figure 17 shows a typical message flow between the consumer, merchant, 
VPOS terminal and the Gateway in accordance with a preferred 
embodiment; 

5 Figures 18A-E are block diagrams of the extended SET architecture in 
accordance with a preferred embodiment; 

Figure 19 is a flowchart of VPOS merchant pay customization in accordance 
with a preferred embodiment; 

10 

Figures 20A-20H are block diagrams and flowcharts setting forth the 
detailed logic of thread processing in accordance with a preferred 
embodiment; 

15 Figure 21 is a detailed diagram of a multithreaded gateway engine in 
accordance with a preferred embodiment; 

Figure 22 is a flow diagram in accordance with a preferred embodiment; 

Figure 23 illustrates a Gateway's role in a network in accordance with a 
20 preferred embodiment; 

Figure 24 is a block diagram of the Gateway in accordance with a preferred 
embodiment; 

Figure 25 is a block diagram of the vPOS Terminal Architecture in 
accordance with a preferred embodiment; 

25 Figure 26 is an architecture block diagram in accordance with a preferred 
embodiment; 
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Figure 27 is a block diagram of the payment manager architecture in 
accordance with a preferred embodiment; 

Figure 28 is a Consumer Payment Message Sequence Diagram in 
5 accordance with a preferred embodiment of the invention; 

Figure 29 is an illustration of a certificate issuance form in accordance with 
a preferred embodiment; 

10 Figure 30 illustrates a certificate issuance response in accordance with a 
preferred embodiment; 

Figure 31 illustrates a collection of payment instrument holders in 
accordance with a preferred embodiment; 

15 

Figure 32 illustrates the default payment instrument bitmap in accordance 
with a preferred embodiment; 

Figure 33 illustrates a selected payment instrument with a fill in the blanks 
20 for the cardholder in accordance with a preferred embodiment; 

Figure 34 illustrates a coffee purchase utilizing the newly defined VISA card 
in accordance with a preferred embodiment of the invention; 

25 Figure 35 is a flowchart of conditional authorization of payment in 
accordance with a preferred embodiment; and 

Figures 36-48 are_screen .displays in accordance with a preferred 

embodiment. 

\> 
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DETAILED DESCRIPTION 

A preferred embodiment of a system in accordance with the present 

5 invention is preferably practiced in the context of a personal computer such 
as the IBM PS/2, Apple Macintosh computer or UNIX based workstation. A 
representative hardware environment is depicted in Figure 1A, which 
illustrates a typical hardware configuration of a workstation in accordance 
with a preferred embodiment having a central processing unit 10, such as a 

10 microprocessor, and a number of other units interconnected via a system 
bus 12. The workstation shown in Figure 1A includes a Random Access 
Memory (RAM) 14, Read Only Memory (ROM) 16, an I/O adapter 18 for 
connecting peripheral devices such as disk storage units 20 to the bus 12, a 
user interface adapter 22 for connecting a keyboard 24, a mouse 26, a 

15 speaker 28, a microphone 32, and/ or other user interface devices such as a 
touch screen (not shown) to the bus 12, communication adapter 34 for 
connecting the workstation to a communication network (e.g., a data 
processing network) and a display adapter 36 for connecting the bus 12 to a 
display device 38. The workstation typically has resident thereon an 

20 operating system such as the Microsoft Windows Operating System (OS), the 
IBM OS/2 operating system, the MAC OS, or UNIX operating system. Those 
skilled in the art appreciates that the present invention may also be 
implemented on platforms and operating systems other than those 
mentioned. 

25 

A preferred embodiment is written using JAVA, C, and the C++ language 
and utilizes object oriented programming methodology. Object oriented 

programming (OOP) has become increasingly used to develop complex 

applications. As OOP moves toward the mainstream of software design and 
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development, various software solutions require adaptation to make use of 
the benefits of OOP. A need exists for these principles of OOP to be applied 
to a messaging interface of an electronic messaging system such that a set 
of OOP classes and objects for the messaging interface can be provided. 

5 

OOP is a process of developing computer software using objects, including 
the steps of analyzing the problem, designing the system, and constructing 
the program. An object is a software package that contains both data and a 
collection of related structures and procedures. Since it contains both data 

10 and a collection of structures and procedures, it can be visualized as a self- 
sufficient component that does not require other additional structures, 
procedures or data to perform its specific task. OOP, therefore, views a 
computer program as a collection of largely autonomous components, called 
objects, each of which is responsible for a specific task. This concept of 

15 packaging data, structures, and procedures together in one component or 
module is called encapsulation. 

In general, OOP components are reusable software modules which present 
an interface that conforms to an object model and which are accessed at 
20 run-time through a component integration architecture. A component 
integration architecture is a set of architecture mechanisms which allow 
software modules in different process spaces to utilize each others 
capabilities or functions. This is generally done by assuming a common 
component object model on which to build the architecture. 

25 

It is worthwhile to differentiate between an object and a class of objects at 
this point. An object is a single instance of the class of objects, which is 
often just called aclass^ A class of objects can beyiewed as^a blueprint, 
from which many objects can be formed. 
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OOP allows the programmer to create an object that is a part of another 
object. For example, the object representing a piston engine is said to have 
a composition-relationship with the object representing a piston. In reality, 
5 a piston engine comprises a piston, valves and many other components; the 
fact that a piston is an element of a piston engine can be logically and 
semantically represented in OOP by two objects. 

OOP also allows creation of an object that "depends from" another object. If 
10 there are two objects, one representing a piston engine and the other 

representing a piston engine wherein the piston is made of ceramic, then the 
relationship between the two objects is not that of composition. A ceramic 
piston engine does not make up a piston engine. Rather it is merely one 
kind of piston engine that has one more limitation than the piston engine; 
15 its piston is made of ceramic. In this case, the object representing the 
ceramic- piston engine is called a derived object, and-it inherits all of the 
aspects of the object representing the piston engine and adds further 
limitation or detail to it. The object representing the ceramic piston engine 
"depends from" the object representing the piston engine. The relationship 
20 between these objects is called inheritance. 

When the object or class representing the ceramic piston engine inherits all 
of the aspects of the objects representing the piston engine, it inherits the 
thermal characteristics of a standard piston defined in the piston engine 
25 class. However, the ceramic piston engine object overrides these ceramic 
specific thermal characteristics, which are typically different from those 
associated with a metal piston. It skips over the original and uses new 
functions related to ceramic pistons. Different kinds of piston engines hav^ 
different characteristics, but may have the same underlying functions 

15 
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associated with it (e.g., how many pistons in the engine, ignition sequences, 
lubrication, etc.). To access each of these functions in any piston engine 
object, a programmer would call the same functions with the same names, 
but each type of piston engine may have different/ overriding 
5 implementations of functions behind the same name. This ability to hide 
different implementations of a function behind the same name is called 
polymorphism and it greatly simplifies communication among objects. 

With the concepts of composition-relationship, encapsulation, inheritance 
10 and polymorphism, an object can represent just about anything in the real 
world. In fact, our logical perception of the reality is the only limit on 
determining the kinds of things that can become objects in object-oriented 
software. Some typical categories are as follows: . 

. £ Objects can represent physical objects, such as automobiles in a 
15 traffic-flow simulation, electrical components in a circuit-design 

program, countries in an economics model, or aircraft in an air-traffic- 
control system. 

£ Objects can represent elements of the computer-user environment 

such as windows, menus or graphics objects. 
20 X An object can represent an inventory, such as a personnel file or a 

table of the latitudes and longitudes of cities. 
X An object can represent user-defined data types such as time, angles, 

and complex numbers, or points on the plane. 

25 With this enormous capability of an object to represent just about any 

logically separable matters, OOP allows the software developer to design and 
implement a computer program that is a model of some aspects of reality, 

whether that„reality is a physical entity, a process, a system, or a 

composition of matter. Since the object can represent anything, the 
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software developer can create an object which can be used as a component 
in a larger software project in the future. 

If 90% of a new OOP software program consists of proven, existing 
5 components made from preexisting reusable objects, then only the 

remaining 10% of the new software project has to be written and tested from 
scratch. Since 90% already came from an inventory of extensively tested 
reusable objects, the potential domain from which an error could originate is 
10% of the program. As a result, OOP enables software developers to build 
10 objects out of other, previously built, objects. 

This process closely resembles complex machinery being built out of 
assemblies and sub-assemblies. OOP technology, therefore, makes software 
engineering more like hardware engineering in that software is built from 
15 existing components, which are available to the developer as objects. All 
this adds up to an improved quality of the software as well-as an increased 
speed of its development. 

Programming languages are beginning to fully support the OOP principles, 
20 such as encapsulation, inheritance, polymorphism, and composition- 
relationship. With the advent of the C++ language, many commercial 
software developers have embraced OOP. C++ is an OOP language that 
offers a fast, machine-executable code. Furthermore, C++ is suitable for 
both commercial-application and systems-programming projects. For now, 
25 C++ appears to be the most popular choice among many OOP programmers, 
but there is a host of other OOP languages, such as Smalltalk, common lisp 
object system (CLOS), and Eiffel. Additionally, OOP capabilities are being 
added to more traditional popular computer programming, languages such„ 
as Pascal. 
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The benefits of object classes can be summarized, as follows: 
£ Objects and their corresponding classes break down complex 
programming problems into many smaller, simpler problems. 
5 £ Encapsulation enforces data abstraction through the organization of 
data into small, independent objects that can communicate with each 
other. Encapsulation protects the data in an object from accidental 
damage, but allows other objects to interact with that data by calling 
the object's member functions and structures. 
10 £ Subclassing and inheritance make it possible to extend and modify 
objects through deriving new kinds of objects from the standard 
classes available in the system. Thus, new capabilities are created 
without having to start from scratch. 
£ Polymorphism and multiple inheritance make it possible for different 
15 programmers to mix and match characteristics of many different 

classes and create specialized objects.that can still work with related 
objects in predictable ways. 
£ Class hierarchies and containment hierarchies provide a flexible 
mechanism for modeling real-world objects and the relationships 
20 among them. 

£ Libraries of reusable classes are useful in many situations, but they 

also have some limitations. For example: 
£ Complexity. In a complex system, the class hierarchies for related 
classes can become extremely confusing, with many dozens or even 
25 hundreds of classes. 

X Flow of control A program written with the aid of class libraries is still 
responsible for the flow of control (i.e., it must control the interactions 
among all the objects created from a particular library). The 
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programmer has to decide which functions to call at what times for 
which kinds of objects. 
X Duplication of effort. Although class libraries allow programmers to 
use and reuse many small pieces of code, each programmer puts 

5 those pieces together in a different way. Two different programmers 

can use the same set of class libraries to write two programs that do 
exactly the same thing but whose internal structure (i.e., design) may 
be quite different, depending on hundreds of small decisions each 
programmer makes along the way. Inevitably, similar pieces of code 

10 end up doing similar things in slightly different ways and do not work 

as well together as they should. 



Class libraries are very flexible. As programs grow more complex, more 
programmers are forced to reinvent basic solutions to basic problems over 

15 and over again. A relatively new extension of the class library concept is to 
have a framework of class libraries. This framework is more complex and 
consists of significant collections of collaborating classes that capture both 
the small scale patterns and major mechanisms that implement the 
common requirements and design in a specific application domain. They 

20 were first developed to free application programmers from the chores 

involved in displaying menus, windows, dialog boxes, and other standard 
user interface elements for personal computers. 

Frameworks also represent a change in the way programmers think about 
25 the interaction between the code they write and code written by others. In 
the early days of procedural programming, the programmer called libraries 
provided by the operating system to perform certain tasks, but basically the 
program execu ted down the page from start to finish, and the programmer 
was solely responsible for the flow of control. This was appropriate for 
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printing out paychecks, calculating a mathematical table, or solving other 
problems with a program that executed in just one way. 

The development of graphical user interfaces began to turn this procedural 
5 programming arrangement inside out. These interfaces allow the user, 
rather than program logic, to drive the program and decide when certain 
actions should be performed. Today, most personal computer software 
accomplishes this by means of an event loop which monitors the mouse, 
keyboard, and other sources of external events and calls the appropriate 
10 parts of the programmer's code according to actions that the user performs. 
The programmer no longer determines the order in which events occur. 
Instead, a program is divided into separate pieces that are called at 
unpredictable times and in an unpredictable order. By relinquishing control 
in this way to users, the developer creates a program that is much easier to 
15 use. Nevertheless, individual pieces of the program written by the developer 
still call libraries provided by the operating system to accomplish certain 
tasks, and the programmer must still determine the flow of control within 
each piece after it's called by the event loop. Application code still "sits on 
top oP the system. 

20 

Even event loop programs require programmers to write a lot of code that 
should not need to be written separately for every application. The concept 
of an application framework carries the event loop concept further. Instead 
of dealing with all the nuts and bolts of constructing basic menus, windows, 
25 and dialog boxes and then making these things all work together, 

programmers using application frameworks start with working application 
code and basic user interface elements in place. Subsequently, they build 
from there by replacing somej)fjthe_generic capabilities of the framework 
with the specific capabilities of the intended application. 



WO 98/37675 PCT/US98/03236 

Application frameworks reduce the total amount of code that a programmer 
has to write from scratch. However, because the framework is really a 
generic application that displays windows, supports copy and paste, and so 
5 on, the programmer can also relinquish control to a greater degree than 
event loop programs permit. The framework code takes care of almost all 
event handling and flow of control, and the programmer's code is called only 
when the framework needs it (e.g., to create or manipulate a proprietary 
data structure). 

10 

A programmer writing a framework program not only relinquishes control to 
the user (as is also true for event loop programs), but also relinquishes the 
detailed flow of control within the program to the framework. This approach 
allows the creation of more complex systems that work together in 
15 interesting ways, as opposed to isolated programs, having custom code, 
being created over and over again for similar problems ~ 



Thus, as is explained above, a framework basically is a collection of 
cooperating classes that make up a reusable design solution for a given 
20 problem domain. It typically includes objects that provide default behavior 
(e.g., for menus and windows), and programmers use it by inheriting some 
of that default behavior and overriding other behavior so that the framework 
calls application code at the appropriate times. 

There are three main differences between frameworks and class libraries: 
25 X Behavior versus protocol Class libraries are essentially collections of 
behaviors that you can call when you want those individual behaviors 
in your program. A framework, on the other hand, provides not only 

behavior but also the protocol or set of rule s that govern the ways in 

which behaviors can be combined, including rules for what a 
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programmer is supposed to provide versus what the framework 
provides. 

£ Call versus override. With a class library, the code the programmer 
instantiates objects and calls their member functions. It's possible to 
instantiate and call objects in the same way with a framework (i.e., to 
treat the framework as a class library), but to take full advantage of a 
framework's reusable design, a programmer typically writes code that 
overrides and is called by the framework. The framework manages the 
flow of control among its objects. Writing a program involves dividing 
responsibilities among the various pieces of software that are called by 
the framework rather than specifying how the different pieces should 
work together. 

X Implementation versus design. With class libraries, programmers 
reuse only implementations, whereas with frameworks, they reuse 
design. A framework embodies the way a family of related programs 
or pieces of software work. It represents a generic, design solution that 
can be adapted to a variety of specific problems in a given domain. 
For example, a single framework can embody the way a user interface 
works, even though two different user interfaces created with the 
same framework might solve quite different interface problems. 

Thus, through the development of frameworks for solutions to various 
problems and programming tasks, significant reductions in the design and 
development effort for software can be achieved. A preferred embodiment of 
the invention utilizes HypeiText Markup Language (HTML) to implement 
documents on the Internet together with a general-purpose secure 
communication protocol for a transport medium between the client and the 
merchant. HTTP or other protocols could be readily substituted for HTML 
without undue experimentation. Information on these products is available 
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in T. Berners-Lee, D. Connoly, "RFC 1866: Hypertext Markup Language - 
2.0" (Nov. 1995); and R. Fielding, H, Frystyk, T. Berners-Lee, J. Gettys and 
J.C. Mogul, "Hypertext Transfer Protocol HTTP/ 1.1: HTTP Working Group 
Internet Draft" (May 2, 1996). HTML is a simple data format used to create 

5 hypertext documents that are portable from one platform to another. HTML 
documents are SGML documents with generic semantics that are 
appropriate for representing information from a wide range of domains. 
HTML has been in use by the World-Wide Web global information initiative 
since 1990. HTML is an application of ISO Standard 8879:1986 Information 

10 Processing Text and Office Systems; Standard Generalized Markup 
Language (SGML). 

To date, Web development tools have been limited in their ability to create 

dynamic Web applications which span from client to server and interoperate 
15 with existing computing resources. Until recently, HTML has been the 

dominant technology used in development of-Web-based solutions. However, 

HTML has proven to be inadequate in the following areas: 

o Poor performance; 

o Restricted user interface capabilities; 
20 o Can only produce static Web pages; 

o Lack of interoperability with existing applications and data; and 

o Inability to scale. 

Sun Microsystem's Java language solves many of the client- side problems 
25 by: 

o Improving performance on the client side; 

o Enabling the creation of dynamic, real-time Web applications; and 
. . o. . Providing the ability to create a wid e variety ofuser interface 
components. 

>3 



WO 98/37675 



PCTYUS98/03236 



With Java, developers can create robust User Interface (UI) components. 
Custom "widgets" (e.g. real-time stock tickers, animated icons, etc.) can be 
created, and client-side performance is improved. Unlike HTML, Java 
5 supports the notion of client-side validation, offloading appropriate 

processing onto the client for improved performance. Dynamic, real-time 
Web pages can be created. Using the above-mentioned custom UI 
components, dynamic Web pages can also be created. 

10 Sun's Java language has emerged as an industry-recognized language for 
"programming the Internet." Sun defines Java as: "a simple, object- 
oriented, distributed, interpreted, robust, secure, architecture-neutral, 
portable, high-performance, multithreaded, dynamic, buzzword-compliant, 
general-purpose programming language. Java supports programming for 

15 the Internet in the form of platform-independent Java applets." Java applets 
are small, specialized applications that comply with Sun's Java Application 
Programming Interface (API) allowing developers to add "interactive content" 
to Web documents (e.g. simple animations, page adornments, basic games, 
etc.). Applets execute within a Java-compatible browser (e.g. Netscape 

20 Navigator) by copying code from the server to client. From a language 

standpoint, Java's core feature set is based on C++. Sun's Java literature 
states that Java is basically "C++, with extensions from Objective C for more 
dynamic method resolution". 

25 Another technology that provides similar function to JAVA is provided by 
Microsoft and ActiveX Technologies, to give developers and Web designers 
wherewithal to build dynamic content for the Internet and personal 
computers. ActiveX includes tools for developing animation, 3-D virtual 
reality, video and other multimedia content. The tools use Internet 
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standards, work on multiple platforms, and are being supported by over 100 
companies. The group's building blocks are called ActiveX Controls, small, 
fast components that enable developers to embed parts of software in 
hypertext markup language (HTML) pages. ActiveX Controls work with a 

5 variety of programming languages including Microsoft Visual C++, Borland 
Delphi, Microsoft Visual Basic programming system and, in the future, 
Microsoft's development tool for Java, code named "Jakarta." ActiveX 
Technologies also includes ActiveX Server Framework, allowing developers to 
create server applications. One of ordinary skill in the art readily recognizes 

10 that ActiveX could be substituted for JAVA without undue experimentation 
to practice the invention. 

Figure IB depicts an overview of the present invention. Customer computer 
system 120 is in communication with merchant computer system 130. The 
customer-merchant session 150 operates under a general-purpose secure 
communication protocol such as the SSL protocol. Merchant computer 
system 130 is additionally in communication with payment gateway 
computer system 140. A payment gateway is a system that provides 
electronic commerce services in support of a bank or other financial 
institution, and that interfaces to the financial institution to support the 
authorization and capture of transactions. The customer-institution session 
170 operates under a variant of a secure payment technology such as the 
SET protocol, as described herein, referred, to as Merchant-Originated 
Secure Electronic Transactions ("MOSET"), as is more fully described herein. 

Customer-to-Merchant Communication 

Figure 2 depicts a more detailed view of customer computer system 120 in 
communication with merchant system 130 using customer-merchant 
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session 150 operating under the SSL protocol as documented in Freier and 
incorporated by reference. 

Customer computer system 120 initiates communication with merchant 
5 computer system 130 using any well-known access protocol, e.g., 

Transmission Control Protocol/ Internet Protocol ("TCP/ IP"). A description of 
TCP/IP is provided in Information Sciences Institute, "Transmission Control 
Protocol DARPA Internet Program Protocol Specification (RFC 793)" 
. (September, 1981), and Information Sciences Institute, "Internet Protocol 
10 DARPA Internet Program Protocol Specification (RFC 791)" (September, 
1981). In this implementation, customer computer system 120 acts as a 
client and merchant computer system 130 acts as a server. 

Customer computer system 120 initiates communication by sending "client 
15 hello" message 210 to the merchant computer system 130. When a client 
first connects to a server it is required to send the client hello message 210 
as its first message. The client can also send a client hello message 210 in 
response to a hello request on its own initiative in order to renegotiate the 
security parameters in an existing connection. The client hello message 
20 includes a random structure, which is used later in the protocol. 

Specifically, the random structure includes the current time and date in 
standard UNIX 3 2 -bit format according to the sender's internal clock and 
twenty-eight bytes of data generated by a secure random number generator. 
The client hello message 210 further includes a variable length session 
25 identifier. If not empty, the session identifier value identifies a session 
between the same client and server whose security parameters the client 
wishes to reuse. The session identifier may be from an earlier connection, 
thexurrent.connection, or another currently active connection. It is useful 
to specify the current connection if the client only wishes to update the 
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random structures and derived values of a connection. It is useful to specify 
another currently active connection if the client wishes to establish several 
simultaneous independent secure connections to the same server without 
repeating the full-handshake protocol. Client hello message 210 further 
5 includes an indicator of the cryptographic algorithms supported by the 
client in order of the client's preference, ordered according to client 
preference. 

In response to client hello message 210, if merchant computer system 130 
10 wishes to correspond with customer computer system 120, it responds with 
server hello message 215. If merchant computer system 130 does not wish 
to communicate with customer computer system 120, it responds with a 
message, not shown, indicating refusal to communicate. 

15 Server hello message 215 includes a random structure, which is used later 
in the protocol; The random structure in server hello message 215 is in the 
same format as, but has contents independent of, the random structure in 
client hello message 210. Specifically, the random structure includes the 
current time and date in standard UNIX 32-bit format according to the 

20 sender's internal clock and twenty-eight bytes of data generated by a secure 
random number generator. Server hello message 215 further includes a 
variable length session identifier. The session identifier value identifies a 
new or existing session between the same client and server. Server hello 
message 215 further includes an indicator of the cryptographic algorithms 

25 selected from among the algorithms specified by client hello message 210, 
which is utilized in further encrypted communications. 
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Optionally, Merchant computer system 130 transmits a server certificate 
220. If transmitted, server certificate 130 enables customer computer 
system 120 to authenticate the identity of merchant computer system 130. 

5 If merchant computer system 130 does not transmit a server certificate 220, 
or if server certificate 220 is suitable only for authentication, it may 
optionally transmit a server key exchange message 225. Server key 
exchange message 225 identifies a key that may be used by customer 
computer system 120 to decrypt further messages sent by merchant 

10 computer system 130. 

After transmitting server hello message 215, and optionally transmitting 
server certificate 220 or server key exchange message 225, merchant 
computer system 130 transmits a server hello done message 230 and waits 
15 for a further response from customer computer system 120. 

Customer computer system 120 optionally transmits client certificate 240 to 
merchant computer system 130. If transmitted, client certificate 240 
enables merchant computer system 130 to authenticate the identity of 
20 customer computer system 120. Alternatively, customer computer system 
120 may transmit a no-client-certificate alert 245, to indicate that the 
customer has not registered with any certification authority. 

If customer computer system 130 does not transmit a client certificate 240, 
25 or if client certificate 240 is suitable only for authentication, customer 
computer system 130 may optionally transmit a client key exchange 
message 250. Client key exchange message 250 identifies a key that may 
be .used.by.merchanLromputer system 130 to decrypt further messages 
sent by customer computer system 120. 
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After optionally transmitting client certificate 240, no-client-certificate alert 
245, and/or client key exchange message 250, customer computer system 
120 transmits a finished message 260. 

5 

At this point, customer computer system 120 and merchant computer 
system 130 have: 

1) negotiated an encryption scheme that may be commonly employed in 
further communications, and 
10 2) have communicated to each other a set of encryption keys that may be 
used to decrypt further communications between the two computer 
systems. 

Customer computer system 120 and merchant computer system 130 may 
15 thereafter engage in secure communications 270 with less risk of 
interception by third parties. 

Among the messages communicated by customer computer system 120 to 
merchant computer system 130 may be messages that specify goods or 

20 services to be ordered and payment information, such as a credit card 
number and related information, collectively referred to as "payment 
information," that may be used to pay for the goods and/or services ordered. 
In order to obtain payment, the merchant must supply this information to 
the bank or other payment gateway responsible for the proffered payment 

25 method. This enables the merchant to perform payment authorization and 
payment capture. Payment authorization is the process by which 
permission is granted by a payment gateway operating on behalf of a 

financial institution to authorize^payment on behalf of the financial 

institution. This is a process that assesses transaction risk, confirms that a 
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given transaction does not raise the account holder's debt above the 
account's credit limit, and reserves the specified amount of credit. Payment 
capture is the process that triggers the movement of funds from the 
financial institution to the merchant's account. 

5 Payment Authorization 

Merchants utilize point-of-sale products for credit and debit transactions on 
a daily basis. An embodiment in accordance with the subject invention 
allows an acquirer processor to accept transactions from internet storefronts 
without altering a current host environment. 

10 The system easily converts payment protocol messages and simultaneously 
manages transactions from a number of internet merchant servers. As the 
number of transactions grows, the payment gateway can be scaled to handle 
the increased business, and it can be configured to work with specific 
business processes used by the acquirer/processor. Thus, the payment 

15 gateway supports internet processing utilizing payment processing 
operations. 

The payment gateway provides support for configuring and installing the 
internet payment capability utilizing existing host point-of-sale technology. 

20 The payment gateway also provides an intuitive Graphical User Interface 
(GUI) with support built in to accommodate future payment instruments 
such as debit cards, electronic checks, electronic cash and micropayments. 
The payment gateway implements secure transactions using RSA public-key 
cryptography and the MasterCard/Visa Secure Electronic Transaction (SET) 

25 protocol. The gateway also provides full functionality for merchant payment 
processing including authorization, capture, settlement and reconciliation 
while providing monitor activity with reporting and tracking of transactions 

sent over the internet. Finally, the payment gateway also implements 

internet payment procedures that match current processor business models 
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to ensure consistency for merchants. Handling internet transactions is 
destined to become a necessary function for every payment procrocessing 
system. Today, merchants oftent transmit data inefficiently. Some fax the 
information or waste time keying data into a non-internet system. 

5 

Figure 3 depicts an overview of the method of securely supplying payment 
information to a payment gateway in order to obtain payment authorization. 
In function block 310, merchant computer system 130 generates a payment 
authorization request 315 and transmits it to payment gateway computer 

10 system 140. In function block 330, payment gateway system 140 processes 
the payment authorization request, generates a payment authorization 
response 325 and transmits it to merchant computer system 130. In 
function block 320, merchant computer system 130 processes payment 
authorization response 325 and determines whether payment for the goods 

15 or services sought to be obtained by the customer has been authorized. 

Payment Authorization Request Generation 

Figure 4 depicts the detailed steps of generating and transmitting a payment 
authorization request. Figures 5A through 5F depict views of the payment 

20 authorization request and its component parts. In function block 410, 

merchant computer system 130 creates a basic authorization request 510. 
The basic authorization request is a data area that includes all the 
information for determining whether a request should be granted or denied. 
Specifically, it includes such information as the party who is being charged, 

25 the amount to be charged, the account number of the account to be 

charged, and any additional data, such as passwords, needed to validate the 
charge. This information is either calculated based upon prior customer 
merchandise selection, or provided by the customer over the secure link 270 
established in the customer-merchant general-purpose secure 
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communication protocol session. Fig 5 A depicts a basic authorization 
request 510. 

In function block 420, merchant computer system 130 combines basic 
5 authorization request 510, a copy of its encryption public key certificate 515 
and a copy of its signature public key certificate 520. Merchant computer 
system 130 calculates a digital signature 525 for the combined contents of 
the combined block 530 comprising basic authorization request 510, the 
encryption public key certificate 515 and the signature public key certificate 

10 520, and appends it to the combination of the combined basic authorization 
request 510, the encryption public key certificate 515 and the signature 
public key certificate 520. The merchant computer system calculates digital 
signature 525 by first calculating a "message digest" based upon the 
contents of the combined basic authorization request 510, the encryption 

15 public key certificate 515 and the signature public key certificate 520. A 
message digest is the fixed-length result that is generated when a variable 
length message is fed into a one-way hashing function. Message digests 
help verify that a message has not been altered because altering the 
message would change the digest. The message digest is then encrypted 

20 using the merchant computer system's 130 digital signature private key, 
thus forming a digital signature. 

Figure 5B depicts the combined block 530. formed by function block 420 
and containing basic authorization request 510, the encryption public key 
25 certificate 515, the signature public key certificate 520, and digital 
signature 525. 

Injunction block 430, merchant computer sys tem 130 generates a random 

encryption key RK-0 540, denoted as RK-O. Random encryption key RK-0 
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540 is a symmetric encryption key. A symmetric encryption key is a key 
characterized by the property that a message encrypted with a symmetric 
key can be decrypted with that same key. This is contrasted with an 
asymmetric key pair, such as a public-key/ private-key key pair, where a 
5 message encrypted with one key of the key pair may only be decrypted with 
the other key of the same key pair. Figure 5C depicts random encryption 
key RK-0 540. 

In function block 440, merchant computer system 130 encrypts combined 
10 block 530 using random encryption key RK-0 540 to form encrypted 
combined block 550. Figure 5D depicts encrypted combined block 550. 
The encryption state of encrypted combined block 550 is graphically shown 
by random key lock 555, which indicates that encrypted combined block 
550 is encrypted using random key RK-0 540. 

15 

In function block 450, merchant computer system 130 encrypts random 
encryption key RK-0 540 using the public key of payment gateway system 
140 to form encrypted random key 560. Figure 5E depicts encrypted 
random key 560. The encryption state of encrypted random key 560 is 
20 graphically shown by payment gateway public key lock 565, which indicates 
that encrypted random key 560 is encrypted using the payment gateway 
public key. 

In function block 460, merchant computer system 130 concatenates 
25 encrypted combined block 550 and encrypted random key 560 to form 
merchant authorization request 315. Figure 5F depicts merchant 
authorization request 315 comprising encrypted combined block 550 and 
encrypted random key 560. In function block 470^ merchant computer 
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system 130 transmits merchant authorization request 315 to payment 
gateway system 140. 

5 Payment Authorization Request Processing 

Figure 6 depicts the detailed steps of processing a payment authorization 
request and generating and transmitting a payment authorization request 
response. Function blocks 610 through 630 depict the steps of processing 
a payment authorization request, while function blocks 635 through 685 
10 depict the steps of generating and transmitting a payment authorization 
request response. 

In function block 610, payment gateway computer system 140 applies its 
private key to encrypted random key 560 contained within received 

15 merchant authorization request 315, thereby decrypting it and obtaining a 
cleartext version of random key RK-0 540. In function block 615, payment . 
gateway computer system 140 applies random key RK-0 540 to encrypted 
combined block 550, thereby decrypting it and obtaining a cleartext version 
of combined block 530. Combined block 530 comprises basic authorization 

20 request 510, a copy of merchant computer system's 130 encryption public 
key certificate 515 and a copy of merchant computer system's 130 
signature public key certificate 520, as well as merchant digital signature 
525. 

25 In function block 620, payment gateway computer system 140 verifies 

merchant computer system's 130 encryption public key certificate 515 and 
merchant computer system's 130 signature public key certificate 520. 
JPayment gateway computer system 140 performs this verification by making 
a call to the certification authorities associated with each certificate. If 
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verification of either certificate fails, payment gateway computer system 140 
rejects the authorization request. 

In function block 625, payment gateway computer system 140 validates 
5 merchant digital signature 525. Payment gateway computer system 140 
performs this validation by calculating a message digest over the contents of 
the combined basic authorization request 510, the encryption public key 
certificate 515 and the signature public key certificate 520. Payment 
gateway computer system 140 then decrypts digital signature 525 to obtain 
10 a copy of the equivalent message digest calculated by merchant computer 
system 130 in function block 420. If the two message digests are equal, the 
digital signature 525 is validated. If validation fails, payment gateway 
computer system 140 rejects the authorization request. 

15 In function block 630, payment gateway computer system 140 determines 
the financial institution for which authorization is required by inspection of 
basic authorization request 510. Payment gateway computer system 140 
contacts the appropriate financial institution using a secure means, e.g, a 
direct-dial modem-to-modem connection, or a proprietary internal network 

20 that is not accessible to third parties, and using prior art means, obtains a 
response indicating whether the requested payment is authorized. 

Payment Authorization Response Generation 

Function blocks 635 through 685 depict the steps of generating and 
25 transmitting a payment authorization request response. Figures 7A through 
7 J depict views of the payment authorization response and its component 
parts. 
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In function block 635, payment gateway computer system 140 creates a 
basic authorization response 710. The basic authorization request is a data 
area that includes all the information to determine whether a request was 
granted or denied. Figure 7A depicts basic authorization response 710. 

5 

In function block 640, payment gateway computer system 140 combines 
basic authorization response 710, and a copy of its signature public key 
certificate 720. Payment computer system 140 calculates a digital signature 
725 for the combined contents of the combined block 730 comprising basic 

10 authorization response 710 and the signature public key certificate 720, 
and appends the signature to the combination of the combined basic 
authorization response 710 and the signature public key certificate 720. 
The payment gateway computer system calculates digital signature 725 by 
first calculating a message digest based on the contents of the combined 

15 basic authorization response 710 and signature public key certificate 720. 
The message digest is then encrypted using the merchant computer system's 
140 digital signature private key, thus forming a digital signature. 

Figure 7B depicts the combined block 730 formed in function block 640 and 
20 containing basic authorization response 710, the signature public key 
certificate 720, and digital signature 725. 

In function block 645, payment gateway computer system 150 generates a 
first symmetric random encryption key 740, denoted as RK-1. Figure 7C 
25 depicts first random encryption key RK-1 740. 

In function block 650, payment gateway computer system 140 encrypts 
combined block 730 using random^encryption key RK-1 740 to form 
encrypted combined block 750. Figure 7D depicts encrypted combined 

3U 
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block 750. The encryption state of encrypted combined block 750 is 
graphically shown by random key lock 755, which indicates that encrypted 
combined block 750 is encrypted using random key RK-1 740. 

5 In function block 655, payment gateway computer system 140 encrypts 
random encryption key RK-1 740 using the public key of merchant 
computer system 130 to form encrypted random key RK 760. Figure 7E 
depicts encrypted random key RK- 1 760. The encryption state of encrypted 
random key 760 is graphically shown by merchant public key lock 765, 

10 which indicates that encrypted random key 760 is encrypted using the 
merchant public key. 

In function block 660, payment gateway computer system 140 generates a 
random capture token 770. Random capture token 770 is utilized in 
15 subsequent payment capture processing to associate the payment capture 
request with the payment-authorization request being processed. Figure 7F 
depicts capture token 775. 

In function block 665, payment gateway computer system 140 generates a 
20 second symmetric random encryption key 775, denoted as RK-2. Figure 7G 
depicts second random encryption key RK-2 775. 

In function block 670, payment gateway computer system 140 encrypts 
capture token 770 using random encryption key RK-2 770 to form 
25 encrypted capture token 780. Figure 7H depicts encrypted capture token 
780. The encryption state of encrypted capture token 780 is graphically 
shown by random key lock 785, which indicates that encrypted capture 
token 780 is encrypted using random key RK-2770. 

>7 
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In function block 675, payment gateway computer system 140 encrypts 
second random encryption key RK-2 775 using its own public key to form 
encrypted random key RK-2 790. Figure 71 depicts encrypted random key 
RK-2 790. The encryption state of encrypted random key 790 is graphically 
5 shown by payment gateway public key lock 795, which indicates that 

encrypted random key 790 is encrypted using the payment gateway public 
key. 

In function block 680, payment gateway computer system 140 concatenates 
encrypted combined block 750, encrypted random key RK- 1 760, encrypted 
capture token 780 and encrypted random key RK-2 790 to form merchant 
authorization response 325. Figure 7J depicts merchant authorization 
response 325 comprising encrypted combined block 750, encrypted random 
key RK- 1 760, encrypted capture token 780 and encrypted random key RK- 
2 790. In function block 685, payment gateway computer system 140 
transmits merchant authorization response 325 to merchant system 130. 

Payment Authorization Response Processing 

Figure 8 depicts the detailed steps of processing a payment authorization 
20 response. In function block 810, merchant computer system 130 applies its 
private key to encrypted random key RK- 1 760 contained within received 
merchant authorization response 325, thereby decrypting it and obtaining a 
cleartext version of random key RK-1 740 v In function block 820, merchant 
computer system 130 applies random key RK-1 740 to encrypted combined 
25 block 750, thereby decrypting it and obtaining a cleartext version of 

combined block 730. Combined block 730 comprises basic authorization 
response 710, a copy of payment gateway computer system's 140 signature 
public key certificate 720, as well as payment gateway digital signature_725. 
In function block 830, merchant computer system 130 verifies payment 
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gateway computer system's 140 signature public key certificate 720. 
Merchant computer system 130 performs this verification by making a call 
to the certification authority associated with the certificate. If verification of 
the certificate fails, merchant computer system 130 concludes that the 
5 authorization response is counterfeit and treats it though the authorization 
request had been rejected. 

In function block 840, merchant computer system 130 validates payment 
gateway digital signature 725. Merchant computer system 130 performs 

10 this validation by calculating a message digest over the contents of the 
combined basic authorization request 710 and the signature public key 
certificate 720. Merchant computer system 130 then decrypts digital 
signature 725 to obtain a copy of the equivalent message digest calculated 
by payment gateway computer system 140 in function block 640. If the two 

15 message digests are equal, the digital signature 725 is validated. If 

validation fails, concludes that the authorization response is counterfeit and 
treats it though the authorization request had been rejected. 

In function block 850, merchant computer system 130 stores encrypted 
20 capture token 780 and encrypted random key RK-2 790 for later use in 
'payment capture. In function block 860, merchant computer system 130 
processes the customer purchase request in accordance with the 
authorization response 710. If the authorization response indicates that 
payment in authorized, merchant computer system 130 fills the requested 
25 order. If the authorization response indicates that payment is not 

authorized, or if merchant computer system 130 determined in function 
block 830 or 840 that the authorization response is counterfeit , merchant 
computer system 130 indicates to the customer that the order cannot be 
filled. 
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Payment Capture 

Figure 9 depicts an overview of the method of securely supplying payment 
capture information to payment gateway 140 in order to obtain payment 

5 capture. In function block 910, merchant computer system 130 generates a 
merchant payment capture request 915 and transmits it to payment 
gateway computer system 140. In function block 930, payment gateway 
system 140 processes the payment capture request 915, generates a 
payment capture response 925 and transmits it to merchant computer 

10 system 130. In function block 920, merchant computer system 130 

processes payment capture response 925 and verifies that payment for the 
goods or services sought to be obtained by the customer have been 
captured. 

1 5 Payment Capture Request Generation 

Figure 10 depicts the detailed steps of generating and transmitting a 
payment capture request. Figures 1 1A through 1 IF depict views of the 
payment capture request and its component parts. In function block 1010, 
merchant computer system 130 creates a basic capture request 510. The 
20 basic capture request is a data area that includes all the information needed 
by payment gateway computer system 140 to trigger a transfer of funds to' 
the merchant operating merchant computer system 130. 

Specifically, a capture request includes a capture request amount, a capture 
25 token, a date, summary information of the purchased items and a Merchant 
ID (MID) for the particular merchant. Figure 11A depicts basic 
authorization request 1110. 
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In function block 1020, merchant computer system 130 combines basic 
capture request 1110, a copy of its encryption public key certificate 1115 
and a copy of its signature public key certificate 1 120. Merchant computer 
system 130 calculates a digital signature 1 125 for the combined contents of 

5 the combined block 1 130 comprising basic capture request 1 1 10, the 
encryption public key certificate 1115 and the signature public key 
certificate 1120, and appends it to the combination of the combined basic 
capture request 1110, the encryption public key certificate 1115 and the 
signature public key certificate 1120. The merchant computer system 

10 calculates digital signature 1125 by first calculating a message digest over 
the contents of the combined basic capture request 1110, the encryption 
public key certificate 1115 and the signature public key certificate 1120. 
The message digest is then encrypted using the merchant computer system's 
130 digital signature private key, thus forming a digital signature. 

15 

Figure 11B depicts the combined block 1130 formed by function block 1020 
and containing basic capture request 1110, the encryption public key 
certificate 1115, the signature public key certificate 1120, and digital 
signature 1125. In function block 1030, merchant computer system 130 

20 generates a random encryption key 1140, denoted as RK-3. Random 
encryption key RK-3 1140 is a symmetric encryption key. Figure 11C 
depicts random encryption key RK-3 1140. In function block 1040, 
merchant computer system 130 encrypts combined block 1130 using 
random encryption key RK-3 1140 to form encrypted combined block 1150. 

25 Figure 11D depicts encrypted combined block 1150. The encryption state of 
encrypted combined block 1150 is graphically shown by random key lock 
1155, which indicates that encrypted combined block 1150 is encrypted 
using random key RK-3 1140. In function block 1050, merchant computer 
system 130 encrypts random encryption key RK-3 1140 using the public 
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key of payment gateway system 140 to form encrypted random key 1160. 
Figure HE depicts encrypted random key 1160. The encryption state of 
encrypted random key 1160 is graphically shown by payment gateway 
public key lock 1165, which indicates that encrypted random key RK-3 
5 1160 is encrypted using the payment gateway public key. 

In function block 1060, merchant computer system 130 concatenates 
encrypted combined block 1150, encrypted random key 1160, and the 
encrypted capture token 780 and encrypted random key RK-2 790 that 

10 were stored in function block 850 to form merchant capture request 915. 
Figure 11F depicts merchant capture request 915, comprising encrypted 
combined block 1150, encrypted random key 1160, encrypted capture 
token 780 and encrypted random key RK-2 790. In function block 1070, 
merchant computer system 130 transmits merchant capture request 915 to 

15 payment gateway system 140. 

Payment Capture Request Processing 

Figure 12 depicts the detailed steps of processing a payment capture 
request and generating and transmitting a payment capture request 

20 response. Function blocks 1210 through 1245 depict the steps of 

processing a payment capture request, while function blocks 1250 through 
1285 depict the steps of generating and transmitting a payment capture 
request response. In function block 1210, payment gateway computer 
system 140 applies its private key to encrypted random key 1160 contained 

25 within received merchant capture request 915, thereby decrypting it and 
obtaining a cleartext version of random key RK-3 1 140. In function block 
1215, payment gateway computer system 140 applies random key RK-3 
1140 to encrypted combined block 1150, thereby decrypting it and 
obtaining a cleartext version of combined block 1130. Combined block 
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1130 comprises basic capture request 1110, a copy of merchant computer 
system's 130 encryption public key certificate 1115 and a copy of merchant 
computer system's 130 signature public key certificate 1120, as well as 
merchant digital signature 1125. In function block 1220, payment gateway 
5 computer system 140 verifies merchant computer system's 130 encryption 
public key certificate 1115 and merchant computer system's 130 signature 
public key certificate 1 120. Payment gateway computer system 140 
performs this verification by making a call to the certification authorities 
associated with each certificate. If verification of either certificate fails, 
10 payment gateway computer system 140 rejects the capture request. 

In function block 1225, payment gateway computer system 140 validates 
merchant digital signature 1125. Payment gateway computer system 140 
performs this validation by calculating a message digest over the contents of 

15 the combined basic capture request 1110, the encryption public key 
certificate 1115 and the signature public key certificate 1120. Payment 
gateway computer system 140 then decrypts digital signature 1125 to 
obtain a copy of the equivalent message digest calculated by merchant 
computer system 130 in function block 1020. If the two message digests 

20 are equal, the digital signature 1125 is validated. If validation fails, 
payment gateway computer system 140 rejects the capture request. In 
function block 1230, payment gateway computer system 140 applies its 
private key to encrypted random key RK-2 790 contained within received 
merchant capture request 915, thereby decrypting it and obtaining a 

25 cleartext version of random key RK-2 775. In function block 1235, payment 
gateway computer system 140 applies random key RK-2 775 to encrypted 
capture token 780, thereby decrypting it and obtaining a cleartext version of 
capture token 770. 
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In function block 1240, payment gateway computer system 140 verifies that 
a proper transaction is being transmitted between capture token 780 and 
capture request 1110. A capture token contains data that the gateway 
generates at the time of authorization. When the authorization is approved, 
5 the encrypted capture token is given to the merchant for storage. At the 
time of capture, the merchant returns the capture token to the gateway 
along with other information required for capture. Upon receipt of the 
capture token, the gateway compares a message made of the capture 
request data and the capture token data and transmits this information over 

10 a traditional credit/ debit network. If an improperly formatted transaction is 
detected, payment gateway computer system 140 rejects the capture 
request. In function block 1245, payment gateway computer system 140 
determines the financial institution for which capture is requested by 
inspection of basic capture request 1 1 10. Payment gateway computer 

15 system 140 contacts the appropriate financial institution using a secure 
means, e.g, a direct-dial modem-to-modem connection, or a proprietary 
internal network that is not accessible to third parties, and using prior art 
means, instructs a computer at the financial institution to perform the 
requested funds transfer. 

20 

Payment Capture Response Generation 

Function blocks 1250 through 1285 depict the steps of generating and 
transmitting a payment capture request response. Figures 13A through 
13P depict views of the payment capture response and its component parts. 

25 

In function block 1250, payment gateway computer system 140 creates a 
basic capture response 710. The basic capture request is a data area that 
includes all the information to indicate whether a capture request was 
granted or denied. Figure 13A depicts basic authorization request 1310. 
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In function block 1255, payment gateway computer system 140 combines 
basic capture response 1310, and a copy of its signature public key 
certificate 1320. Payment computer system 140 calculates a digital 
5 signature 1325 for the combined contents of the combined block 1330 
comprising basic capture response 1310 and the signature public key 
certificate 1320, and appends the signature to the combination of the 
combined basic authorization request 1310 and the signature public key 
certificate 1320. The payment gateway computer system calculates digital 
10 signature 1325 by first calculating a message digest over the contents of the 
combined basic capture response 1310 and signature public key certificate 
720. The message digest is then encrypted using the merchant computer 
system's 140 digital signature private key, thus forming a digital signature. 

Figure 13B depicts the combined block 1330 formed by function block 1255 
and containing basic capture request 1310, the signature public key 
certificate 1320, and digital signature 1325. In function block 1260, 
payment gateway computer system 140 generates a symmetric random 
encryption key 1340, denoted as RK-4. Figure 13C depicts random 
encryption key RK-4 1340. In function block 1275, payment gateway 
computer system 140 encrypts combined block 1330 using random 
encryption key RK-4 1340 to form encrypted combined block 1350. Figure 
13D depicts encrypted combined block 1350. The encryption state of 
encrypted combined block 1350 is graphically shown by random key lock 
1355, which indicates that encrypted combined block 1350 is encrypted 
using random key RK-4 1340. In function block 1275, payment gateway 
computer system 140 encrypts random encryption key RK-4 1340 using the 
public key of merchant computer system 130 to form encrypted random key 
RK-4 1360. Figure 13E depicts encrypted random key RK-4 1360. The 
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encryption state of encrypted random key 1360 is graphically shown by 
merchant public key lock 1365, which indicates that encrypted random key 
1360 is encrypted using the merchant public key. In function block 1280, 
payment gateway.computer system 140 concatenates encrypted combined 
5 block 1350 and encrypted random key RK-4 1360 to form merchant 

capture response 925. Figure 13F depicts merchant capture response 925 
comprising encrypted combined block 1350 and encrypted random key RK- 
4 1360. In function block 1285, payment gateway computer system 140 
transmits merchant capture response 925 to merchant system 130. 

10 

Payment Capture Response Processing 

Figure 14 depicts the detailed steps of processing a payment capture 
response. In function block 1410, merchant computer system 130 applies 
its private key to encrypted random key RK-4 1360 contained within 

15 received merchant capture response 925, thereby decrypting it and 

_ . obtaining a cleartext version of random key RK-4 1340. In function block 
1420, merchant computer system 130 applies random key RK-4 1340 to 
encrypted combined block 1350, thereby decrypting it and obtaining a 
cleartext version of combined block 1330. Combined block 1330 comprises 

20 basic capture response 13 10, a copy of payment gateway computer system's 
140 signature public key certificate 1320, as well as payment gateway 
digital signature 1325. In function block 1430, merchant computer system 
130 verifies payment gateway computer system's 140 signature public key 
certificate 1320. Merchant computer system 130 performs this verification 

25 by making a call to the certification authority associated with the certificate. 
If verification of the certificate fails, merchant computer system 130 
concludes that the capture response is counterfeit and raises an error 
condition. 
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In function block 1440, merchant computer system 130 validates payment 
gateway digital signature 1325. Merchant computer system 130 performs 
this validation by calculating a message digest over the contents of the 
combined basic authorization request 1310 and the signature public key 

5 certificate 1320. Merchant computer system 130 then decrypts digital 
signature 1325 to obtain a copy of the equivalent message digest calculated 
by payment gateway computer system 140 in function block 1255. If the 
two message digests are equal, the digital signature 1325 is validated. If 
validation fails, merchant computer system 130 concludes that the 

10 authorization response is counterfeit and raises an error condition. In 
function block 1450, merchant computer system 130 stores capture 
response for later use in by legacy system accounting programs, e.g. to 
perform reconciliation between the merchant operating merchant computer 
system 130 and the financial institution from whom payment was 

15 requested, thereby completing the transaction. The system of the present 
invention permits immediate deployment of a secure payment technology 
architecture such as the SET architecture without first establishing a 
public-key encryption infrastructure for use by consumers. It thereby 
permits immediate use of SET-compliant transaction processing without the 

20 need for consumers to migrate to SET-compliant application software. 

VIRTUAL POINT OF SALE (VPOS) DETAILS 

A Virtual Point of Sale (VPoS) Terminal Cartridge is described in accordance 
with a preferred embodiment. The VPoS Terminal Cartridge provides 
25 payment functionality similar to what a Verifone PoS terminal ("gray box") 
provides for a merchant today, allowing a merchant to process payments 
securely using the Internet. It provides full payment functionality for a 
variety of payment instruments. 
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Payment Functionality 

Figure ISA illustrates a payment processing flow in accordance with a 
preferred embodiment. The payment functionality provided by the VPoS 
terminal is divided into two main categories: "Merchant-Initiated* 1510 and 

5 "Consumer-Initiated" 1500. Some payment transactions require 

communication with the Acquirer Bank through the Gateway 1530. The 
normal flow of a transaction is via the VPoS Cartridge API 1512 to the VPoS 
C++ API 1514 into the payment protocol layer 1516 which is responsible for 
converting into legacy format for utilization with existing host payment 

10 authorization systems. The output from the payment protocol layer 1516 is 
transmitted to the authorization processing center via the gateway 1530. 
These transactions are referred to as "Online Transactions" or "Host 
Payments." The transactions that can be done locally by the merchant 
without having to communicate with the Acquirer Bank are referred to as 

15 "Local Functions and Transactions." To support different types of payment 
instruments, the VPoS Terminal payment functionality is categorized as set 
forth below. 

• Host Payment Functionality: These transactions require 
20 communication with the final host, either immediately or at a later stage. 
For example, an Online Authorization-Only transaction, when initiated, 
communicates with the host immediately. However, an Off-line 
Authorization-Only transaction is locally authorized by the VPoS terminal 
without having to communicate with the host, but at a later stage this 
25 off-line authorization transaction is sent to the host. Within the Host 
Payment Functionality some transactions have an associated Payment 
Instrument, while others do not. These two kinds of transactions are: 

• Host Financial Payment Functionality :~ These transactions have a 

Payment Instrument (Credit Card, Debit Card, E-Cash, E-Check, etc.) 
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associated with them. For example, the "Return* transaction, which is 
initiated upon returning a merchandise to the merchant. 

• H st Administrative Payment Functionality: These transactions do 
not require a payment instrument, and provide either administrative or 

5 inquiry functionality. Examples of these transactions are "Reconcile* or 
the "Batch Close." 

• Local Functions and Transactions: These transactions do not require 
communication with the host at any stage, and provide essential VPoS 
terminal administrative functionality. An example of this is the VPoS 

10 terminal configuration function, which is required to set up the VPOS 

terminal. Another example is the "VPoS Batch Review* function, which is 
required to review the different transactions in the VPoS Batch or the 
Transaction Log. 

Payment Instruments 

15 A preferred embodiment of a VPoS terminal supports various Payment 
Instruments. A consumer chooses a payment based on personal 
preferences. Some of the Payment Instruments supported include: 

• Credit Cards 

• Debit Cards 

20 • Electronic Cash 

• Electronic Checks 

• Micro-Payments (electronic coin) 

• Smart Cards 

URL Table 

25 The table below enumerates the URLs corresponding to the transactions 
supported by the VPoS Terminal Cartridge. Note that the GET method is 
Slowed for all transactions; however, for transactions that either create or 
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modify information on the merchant server, a GET request returns an HTML 
page from which the transaction is performed via a POST method. 



Transaction URL 



POST 



Access Control 



Host Financial Payment Functionality 

auth capture /vpost/mi/authcap allowed 
ture/ 

auth capture /vpost/ci/authcapt allowed 
ure/ 

auth only /vpost/mi/authonl allowed 

y/ 

auth only /vpost/ci/authonly allowed 

/ 

adjust /vpost/ mi/adjust/ allowed 



forced post 

offline auth 

offline auth 

pre auth 

pre auth 

comp 

return 

return 



/ vpost / mi / forcedpo allowed 
st/ 

/vpost /mi / offlineau allowed 
th/ 

/vpost/ci/offlineaut allowed 
h/ 

/ vpost /mi/ preau th allowed 
/ 

/vpost/mi/preauth allowed 
comp/ 

/ vpost/ mi/ return allowed 



merchant 
login /pas sword 
no access control 

merchant 
login/password 
no access control 

merchant 
login / password 
merchant 
login/ password 
merchant 
login /password 
no access control 

merchant 
login /password 
merchant 
login/password 
merchant 
login /password 



/vpost/ ci/ return/ allowed no access control 
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void 


/vpost/mi/void/ 


allowed 


merchant 








login/ password 


Host Administrative Payment Functionality 




balance 


/vpost/mi/bi/ 


not 


merchant 


inquiry 




allowed 


login/password 


host logon 


/ vpost / mi/hostlogo 

1 ST I 1 O 


allowed 


merchant 




n/ 




login/ password 


parameter 


/vpost /mi/ paramet 


not 


merchant 


download 


ersdnld/ 


allowed 


login/ password 


reconcile 


/vpost /mi/ reconcile 


allowed 


TTl f*Tr*Vl Qtlt 
1I-LCI ^.llCU.1 L 




/ 




login/ password 


test host 


/vpost /mi/ testhost 


not 


merchant 




/ 


allowed 


login/ password 


Local Functions & Transactions 






accum review 


/vpost/mi/accum/r 


not 


merchant 




eview/ 


allowed 


login/ password 


batch review 


/vpost /mi/ batch/ re 


not 


merchant 




view/ 


allowed 


login/ password 


cdt review 


/vpost/mi/cdt/revi 


not 


merchant 




ew/ 


allowed 


login/ password 


cdt update 


/vpost/mi/cdt/upd 


allowed 


merchant 




ate/ 




login/ password 


cpt review 


/vpost/mi/cpt/revi 


not 


merchant 




ew 


allowed 


login /password 


cpt update 


/vpost/mi/ cpt/upd 


allowed 


merchant 




ate/ 




login/password 


clear accum 


/vpost / accum/ clea 


allowed 


merchant 
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clear batch 
hdt review 
hdt update 
lock vpos 
query txn 
query txn 
tct review 
tct update 
unlock vpos 



r/ 

/ vpo st / mi/ batch / cl allowed 
ear/ 

/ vpost /mi/ hdt / revi not 

ew/ allowed 

/ vpost /mi/ hdt / upd allowed 
ate/ 

/ vpost/mi / lock / allowed 

/ vpost/ci/querytxn not 

/ allowed 

/vpost/mi/querytx not 

n / allowed 

/vpost/mi/ tct/revie not 

w/ allowed 

/vpost/mi/tct/upd allowed 
ate/ 

/vpost /mi/ unlock / allowed 



login/ password 
merchant 
login/ password 
merchant 
login / password 
merchant 
login/ password 
merchant 
login/ password 
no access control 

merchant 
login /password 
merchant 
login/ password 
merchant 
login /password 
merchant 
login /password 
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URL Descriptions 

This section describes the GET and POST arguments that are associated 
with each transaction URL. It also describes the results from the GET and 
POST methods. For URLs that produce any kind of results, the following 
fields are present in the HTML document that is returned by the VPoS 
Terminal Cartridge: 

txnDate Date of the transaction (mm/dd/yy or 
dd/mm/yy) 

txnTime Time of the transaction (hh:mm:ss GMT or 

hh:mm:ss local time) 
merchantld Merchant ID of the merchant using the VPoS 

terminal 
terminalld VPoS Terminal Id 

txnNum Transaction number of the given transaction 
txnType Type of transaction 

For URLs that deal with financial transactions, the following fields are 
present in the HTML document that is returned by the VPoS terminal 
cartridge: 

txnAmount Transaction amount that is being authorized, 

forced posted, voided, etc. 
poNumber Purchase order number 
authldentN Authorization ID number for the transaction 
um 

retRefNum Retrieval reference number for the given 
transaction 
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pilnfo Payment instrument information. This varies for 

different payment instruments. For example, in 
the case of credit cards, the credit card number 
(piAcctNumber) and expiration date (piExpDate) 
are returned. 

Accumulate Review 

URL Functionality: This is a local information inquiry function that 
retrieves the local (merchant's) transaction totals (accumulators). 
GET Arguments: None. 
5 GET Results: Retrieves the transaction totals for the merchant. Currently, 
the total is returned as an HTML document. The transaction totals currently 
returned are: 

creditAmt Total Credit Amount since the last settlement 

logged in the VPoS terminal 
creditCnt Total Credit Count since the last settlement 

logged in the VPoS terminal 
debitAmt Total Debit Amount since the last settlement 

logged in the VPoS terminal 
debitCnt Total Debit Count since the last settlement 

logged in the VPoS terminal 

10 Note: Accum Review is a local function, as opposed to Balance Inquiry 
which is done over the Internet with the host. 

Adjust 

URL Functionality: Corrects the amount of a previously completed 

transaction: — 

15 GET Arguments: None 
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GET Results: Because the Adjust transaction modifies data on the 
merchant server, the POST method should be used. Using the GET method 
returns an HTML form that uses the POST method to perform the 
transaction. 
5 POST Arguments: 

pvsTxnNum Previous transaction number 
txnAdjustedA The adjusted transaction amount. Note that 
mount the original transaction amount is easily 

retrievable from the previous transaction 

number. 



POST Results: On success, pvsTxnNum and txnAdjusted Amount are 
presented in the HTML document, in addition to the transaction fields 
10 described above. 

Auth Capture 

URL Functionality: This transaction is a combination of Auth Only 
(Authorization without capture) and Forced Post transactions. 

15 GET Arguments: None 

GET Results: Because the Auth Capture transaction modifies data on the 
merchant server side, the POST method should be used. Using the GET 
method returns an HTML form that uses the POST method to perform the 
transaction. 

20 POST Arguments: 

piAcctNum Payment Instrument account number, e.g., Visa 
ber credit card number 
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piExpDate Expiration date 
txnAmt Transaction amount 

POST Results: On success, an HTML document that contains the 
transaction fields described above is returned. On failure, an HTML 
document that contains the reason for the failure of the transaction is 
5 returned. The transaction is logged into a VPoS Terminal transaction log for 
both instances. 

Auth Only 

URL Functionality: Validates the cardholder's account number for a Sale 
that is performed at a later stage. The transaction does not confirm the sale 
10 to the host, and there is no host data capture. The VPoS captures this 
transaction record and later forwards it to confirm the sale in the Forced 
Post transaction request. 
GET Arguments: None. 

GET Results: Because the Auth Only transaction modifies data on the 
15 merchant server side, the POST method should be used. Using the GET 
method returns an HTML form that uses the POST method to perform the 
transaction. 
POST Arguments: 

piAcctNum Payment Instrument account number, e.g., Visa 

ber credit card number 

piExpDate Expiration date 

txnAmt Transaction amount 



20 POST Results: On success, an HTML document that contains the 

transaction fields is returned. On failure, an HTML document that contains 
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the reason for the failure of the transaction is returned. The transaction is 
logged into VPoS Terminal transaction log for both instances. 
Note: The /vpost/ci/authonly/ URL should be used for customer-initiated 
transactions, /vpost/mi/authonly/ should be used for merchant-initiated 
5 transactions. 

Balance Inquiry 

URL Functionality: Performs an on-line inquiry or the merchant's balance. 
GET Arguments: None 
10 GET Results: 

mrchtBlnce Merchant balance amount for a given merchant. 

Amt The balance amount at any given time is the 

difference between the credit and debit amount 
since the last settlement between the merchant 
and the acquirer. 



Batch Review 

URL Functionality: Retrieves all records from the transaction log or the 
15 batch. 

GET Arguments: None 

GET Results: The GET method retrieves the transactions that have been 
batched in the VPoS terminal for future reconciliation. The batch can be 
cleared from the VPoS terminal after a manual reconciliation between the 
20 acquirer and the VPoS. The batch data is retrieved as a set of records and is 
formatted as a table in the HTML document. The following fields are present 
in a typical record: " — 
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nTransType Transaction type 

nPurchOrder Purchase order number 
No 

szAcctNum Customer's payment instrument account 
number 

szExpDate Customer's payment instrument expiration 
date 

szTransAmt Transaction amount 

s^TransDate Transaction date 

sZTransTime Transaction time 

szRetrievalRef Transaction's retrieval reference number 
Num 

szAuthld Authorization ID for the transaction 

szOrigAmt Original transaction amount 

szBatchNum Batch number for the given transaction 

nCurrencyTyp Currency in which the transaction was done 
e 

InTransNum Transaction number 



CDT Review 

URL Functionality: Displays the VPoS terminal configuration data 
corresponding to the Card Definition Table (CDT). 
5 GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains 
the current configuration values. The form can be modified and posted using 
the /vpost/ mi/ cdt/ update/ URL to update the card definition table. Not all 
fields in the card definition table are editable. The following fields are 
10 returned in a form to the user: 
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nHostlndex Index into the Host Definition Table or the 
Acquirer that maps to this card issuer. 

szPANLo Low end of the PAN (Primary Account Number) 

range 

szPANHi High end of the PAN range 

nMaxPANDigi Maximum number of digits in the PAN for this 

t acquirer. 

NMinPANDigit Minimum number of dits in the PAN for the 
acquirer 

szCardLabel Card Issuer's name 

Transactions Specifies if a particular transaction is allowed 

Available bit for a given card range. 

vector 



(Some of these fields are not editable by a merchant, and still need to be 
determined.) 

5 

CDT Update 

URL Functionality: Updates the VPoS terminal configuration data 

corresponding to the Card Definition Table (CDT). 

GET Arguments: None 
10 GET Results: The GET method returns a default HTML form that contains 

the current configuration values. The form can be filled out and posted 

using the /vpost/mi/cdt/update URL to update the card definition table. 

POST Arguments: (Editable CDT fields need to be decided.) 

POST Results: (Depends on editable CDT fields, and therefore needs to be 
15 decided.) 
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Clear Accumulator 

URL Functionality: Zeroes out the accumulator totals currently resident in 
the VPoS terminal. 
5 GET Arguments: None. 

GET Results: Presents a form that uses the POST method to zero the 

accumulators. 

POST Arguments: None. 

POST Results: Zeroes the accumulators/ transaction totals in the VPoS 
10 terminal. 



Clear Batch 

URL Functionality: Zeroes out the transaction logs currently batched in the 
VPoS terminal. 
15 GET Arguments: None. 

GET Results: Presents a form that uses the POST method to clear the 
batch. 

POST Arguments: None. 

POST Results: Zeroes the transactions that comprise the batch in the VPoS 
20 terminal. 



Forced Post 

URL Functionality: Confirms to the host the completion of a sale, and 
requests for data capture of the transaction. This is used as a follow-up 
25 transaction after doing an Authorization (Online or Off-line) transaction. 
GET Arguments: None.- __ 
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GET Results: Returns the HTML form for performing the Forced Post 



transaction. 



POST Argum nts: 



pvsTxnNum the previous transaction number from an auth 
only transaction 



5 



POST Results: On success, pvsTxnNum is presented in the HTML 
document. On failure, an HTML document is returned that contains the 
reason for the failure of the transaction. 



URL Functionality: Displays the VPoS terminal configuration data 
corresponding to the Host Definition Table (HDT). 
GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains 
15 the current configuration values. The form can be modified and posted using 
the /vpost/mi/hdt/update URL to update the hosts definition table. Not all 
fields in the host definition table are editable. The following fields are 
returned in a form to the user: 



10 



HDT Review 



szTermld 



Terminal ID for this VPoS terminal 



szMerchld 



Merchant ID for this VPoS terminal 



szCurrBatchN 



Current batch number existing on the VpoS 



um 



szTransNum 



Reference number for the next transaction in 



the VPoS transaction log/batch. This is 
generated by VPoS and is not editable by the 
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S^TPDU 



InSTAN 



szNII 

szHostName 

nHostType 

nNumAdv 



Data Capture 
Required Bit 
vector: 



merchant. 

Transport Protocol Data Unit. Required for 

building the ISO 8583 packet. 

System trace number; message number of the 

next transaction to be transmitted to this 

acquirer. 

Network International Number. Required for 
building the ISO 8583 packet. 
Name for identifying the host. 
Host type 

Number of off-line transactions that can be 
piggy-backed at the end of an on-line 
transaction. 

Specifies for which transactions data capture 
is required. 



(Some of these fields are not editable by a merchant and need to be 
determined.) 



5 HDT Update 

URL Functionality: Updates the VPoS terminal configuration data 
corresponding to the Host Definition Table (HDT). 
GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains 
10 the current configuration values. The form can be filled out and posted to 
the merchant server using the /vpost/mi/hdt/update URL to update the 
host definition table 

[*1 
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Unlock VPOS 



URL Functionality: Local function that starts the VPOS at the start of the 
day. 

GET Arguments: -None. 
5 GET Results: Returns an HTML form that uses the POST method to perform 
this transaction. 
POST Arguments: None. 

POST Results: Resets a Boolean flag on the merchant server that enables 
transactions to be accepted by the VPoS terminal. 

10 Offline Auth 

URL Functionality: This transaction is same as the "Authorization Only" 
transaction, except that the transaction is locally captured by the VPoS 
terminal without having to communicate with the host. A Forced Post 
operation is done as a follow-up operation of this transaction. 

15 GET Arguments: None. 

GET Results: Because the Offline Auth transaction modifies data on the 
merchant server side, the POST method should be used. Using the GET 
method returns an HTML form for using the POST method to perform the 
transaction. 

20 POST Arguments: 



POST Results; On success, an HTML document that contains the 
transaction fields described in Section 4.1 is returned. On failure, an HTML 
document that contains the reason for the failure of the transaction is 



piExpDate 



piAcctNum 



ber 



txnAmt 



Payment Instrument account number, e.g., Visa 
credit card number 
Expiration date 
Transaction amount 
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returned. The transaction is logged into VPoS terminal transaction log for 
both instances. 



Parameter Download 
5 URL Functionality: Downloads the VPoS configuration information from 
the host and sets up the VPOS in the event of the configuration data being 
changed. 

GET Arguments: None 

GET Results: Retrieves an HTML form that uses the POST method for the 
10 parameter download transaction. 
POST Arguments: None. 

POST Results: Downloads the following parameters from the host and 
uploads them into the VPoS terminal configuration table. 

• card/ issuer definition table (CDT) 
15 • host/ acquirer definition table (HDT) 

• communications parameter table (CPT) 

• terminal configuration table (TCT) 

The various configuration parameters can be reviewed and modified using 
the URLs for the desired functionality. 

20 Pre Auth 

URL Functionality: Used in lodging and hotel establishments to pre- 
authorize a charge that is completed some time in future. 
GET Arguments: None 

GET Results: Retrieves the HTML form for posting the pre-authorizaton 
25 transaction. 

POST Arguments: 
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piAcctNum Payment Instrument account number, e.g.. Visa 
ber credit card number 

piExpDate Expiration date 

Pre Auth Comp 

URL Functionality: Completes a pre-aiithorization transaction. 
GET Arguments: None 

GET Results: Retrieves the HTML form for posting the pre-authorization 
5 completion transaction. 
POST Arguments: 

pvsTxnNum Previous transaction number from an auth only 
transaction 

POST Results: On success, pvsTxnNum is presented in the HTML 
10 document. On failure, an HTML document is returned that contains the 
reason for the failure of the transaction. 



Reconcile 

URL Functionality: This transaction is done at the end of the day to 
15 confirm to the host to start the settlement process for the transactions 
captured by the host for that particular VPoS batch. 
GET Arguments: None 

GET Results: Retrieves the HTML form for posting the Reconcile 
transaction. 
20 POST Arguments: None. 

POST Results: On success, the reconcile function prints~any discrepancies 

in the merchant's batch of transactions and totals vis-a-vis the host's batch 
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of transactions in totals. The output format is a combination of the output of 
the Batch Review and Accum Review transactions. 

Return 

5 URL Functionality: Credits the return amount electronically to the 

consumer's account when previously purchased merchandise is returned. 
The VPoS terminal captures the transaction record for this transaction. 
GET Arguments: None 

GET Results: Retrieves the HTML form for posting the Return transaction. 
10 POST Arguments: 

prevTxnNu Reference to the previous transaction number 
m 

The previous transaction has access to the following fields: 

txnAmount Transaction amount 

piAccountN Payment instrument account number 

um 

piExpDate Payment instrument expiration date 

15 

POST Results: On success, pvsTxnNum is presented in the HTML 
document, in addition to 

Test Host 

URL Functionality: Checks the presence of the host and also the integrity 

20 of the link from the- VPoS to-the host. 

GET Arguments: None. 
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GET R suits: On success, an HTML document is returned that reports 
success in connecting to the host. On failure, an HTML document is 
returned that reports the error encountered in testing the host. 

5 Lock VPOS 

URL Functionality: This local function locks or stops the VPoS terminal 
from accepting any transactions. 
GET Arguments: None. 

GET Results: Returns an HTML form that posts the locking of the VPoS 
10 terminal. 

POST Arguments: None. 

POST Results: On success, an HTML document is returned that contains 
the status that VPoS terminal was successfully. On failure, an HTML 
document is returned that reports the cause of failure of the operation, e.g., 
15 access denied, the VPoS terminal is already locked or is presently processing 
a transaction, etc. 

Void 

URL Functionality: Cancels a previously completed draft capture 
transaction. 
20 GET Arguments: None. 

GET Results: Retrieves an HTML form for posting the Void transaction. 
POST Arguments: 

pvsTxnNum Transaction number from a previous Auth Only 
transaction. 
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Host Logon 

URL Functionality: Administrative transaction used to sign-on the VPoS 
with the host at the start of the day, and also to download encryption keys 
for debit transactions. 
5 GET Arguments: None 

GET Results: Retrieves an HTML form for posting the Host Logon 
transaction. 

POST Arguments: None. 

POST Results: Currently, debit card based transactions are not supported. 
10 The result is an HTML document indicating the success or failure of the host 
logon operation. 

CPT Review 

URL Functionality: Returns the VPoS terminal configuration data 
corresponding to the Communications Parameter Table (CPT). 
GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains 
the current configuration values corresponding to the VPoS terminal's 
communication parameters. The form can be filled out and posted to the 
merchant server using the /vpost/mi/cpt/update URL to update the 
communications parameter table. The following fields are returned in a form 
to the user: 

szAcqPriAddre Primary Host address 
ss 

szAcqSecAddre Secondary Host address 
ss 

szActTerAddre Tertiary Host address 
ss 



15 



20 
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nRespTimeOut Time-out value (in seconds) before which the 
VPoS should receive a response from the host 



CPT Update 

URL Functionality: Updates the VPoS terminal configuration data 
corresponding to the Communications Parameter Table (CPT). 
GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains 
the current configuration values. The form can be modified and posted to 
update the communication parameter table. 
POST Arguments: 

szAcqPriAddre Primary Host address 
ss 

szAcqSecAddre Secondary Host address 
ss 

szActTerAddre Tertiary Host address 
ss 

nRespTimeOut Time-out value (in seconds) before which the 
VPoS should receive a response from the host 

POST Results: On success, the HTML document returned by the VPoS 
contains the values set by the merchant. On failure, the HTML document 
contains the reason for the failure of the invocation of the URL. 

TCT Review 

URL Functionality: Returns the VPoS terminal configuration data 

corresponding to the Terminal Configuration Table (TCT) . 

GET Arguments: None. 
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GET Results: The GET method returns a default HTML form that contains 
the current configuration values. The form can be filled out and posted 
using the /vpost/mi/tct/update URL to update the terminal configuration 
table. The following fields are returned in a form to the user: 

5 

szMerchName Merchant name 
szSupervisorP Supervisor password 
wd 

fvPOSLock 1= VPoS locked, 0 = VPoS unlocked 
szAuthOnlyPw Password for initiating auth-only transaction 
d 

szAuthCaptPw Password for initiating auth with capture 

d transaction 

szAdjustPwd Password for adjust transaction 

szRefundPwd Password for refund transaction 

szForcedPostP Password for forced post transaction 

wd 

szOfflineAuthP Password for offline auth transaction 
wd 

szVoidPwd Password for void transaction 
szPreAuthPwd Password for pre-authorization transaction 
szPreAuthCom Password for pre-authorization completion 
pPwd 



TCT Update 

URL Functionality: Updates the VPoS terminal configuration data 
corresponding to the Terminal Configuration Table (TCT). 
10 GET Arguments: None 
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GET Results: The GET method returns a default HTML form that contains 
the current configuration values. The form can be filled out and posted 
using the /vpost/ mi/ tct/ update URL to update the terminal configuration 
table. 

POST Arguments: All arguments in TCT Review functionality are the 
returned values from the /vpost/mi/tct/update the URL. 

szMerchName Merchant name 

szSupervisorP Supervisor password 
wd 

fvPOSLock 1= VPoS locked, 0 = VPoS unlocked 

szAuthOnlyPw Password for initiating auth-only transaction 
d 

szAuthCaptPw Password for initiating auth with capture 

d transaction 

szAdjustPwd Password for adjust transaction 

szRefundPwd Password for refund transaction 

szForcedPostP Password for forced post transaction 

wd 

szOfflineAuthP Password for offline auth transaction 
wd 

szVoidPwd Password for void transaction 

szPreAuthPwd Password for pre-authorization transaction 

szPreAuthCom Password for pre-authorization completion 
pPwd 

POST Results: On success, the POST modifies values of the terminal 
configuration table parameters. On failure, the HTML document contains 

the reason for the failure of the transaction. 
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Query Transactions 

URL Functionality: Permits the merchant and customer to query a given 
transaction corresponding to a transaction number. 
GET Arguments: - 

txnNum Transaction number 

5 

GET Results: For a given transaction, the URL returns an HTML document. 
If a transaction refers to an older transaction, the transaction's entire 
history is made available. 

URL results 

Depending upon the method (GET/POST) as well as the success or failure of 
the HTTP request, different documents are returned to the user. The VPoS 
terminal provides a framework whereby different documents are returned 
based upon a number of preferences. Currently the language and content- 
type are supported as preferences. 

A simple framework is proposed here. Each of the transaction has a set of 
documents associated with it: form for the payment transaction, GET 
success, GET failure, POST success, and POST failure. 

20 In the directory structure defined below, documents are stored 

corresponding to the preferences. The top level of the directory structure is 
the content- type, the next level is language (for NLS support). For example, 
to create text /html content in US English & French, the directory structure 
given below would contain the HTML documents for each of the 

25 transactions. The VPoS terminal cartridge has a configuration file that 
allows the user to specify the content-type as well as the language to be 
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used for a cartridge. The first release of the VPoS terminal cartridge 
supports one content-type and language for each server. 

Data Structures & Functions 
Functions 

5 A brief description of the Virtual Point of Sale Terminal cartridge functions 
are provided below. VPosfInit(), VPosTExecQ and VPosTShut() are the entry 
points required for each cartridge in accordance with a preferred 
embodiment. The other functions implement some of the key VPoST 
cartridge functionality. 

VPosTInit() 

/* VPosT cartridge Initialization here */ 
WRBReturnCode 
VPosTInit( void **clientCtx ){ 
vPosTCtx *vPosTCxp ; 
/* Allocate memory for the client context */ 
if (!(vPosTCxp = (vPosTCtx *)malloc(sizeof(vPosTCtx)))) 
return WRBJERROR ; 
*clientCtx = (void *)vPosTCxp ; 
return (WRBJ30NE) ;} 

20 VPosTShut{) 

WRBReturnCode 

VPosTShut( void *WRBCtx, void *clientCtx ){ 
*WRBCtx; /* not used*/ 
assert( clientCtx ) ; 
25 /* Free the client context allocated in VPosTInit() routine 
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free( clientCtx ) ; 
return (WRB_DONE) ;} 

VPosTExecO 

/* The driver cartridge routine */ 
WRBReturnCode 

VPosTExec( void *WRBCtx, void *clientCtx ) 
{ 

vPoSTCtx *vPosTCxp ; 
char *uri ; 

char *txnMethod ; /* HTTP method */ 

enum eVPoSTTxn *txn ; /* VPosT transaction */ 

char *txnOutFile ; /* Output file from transaction */ 

char **txnEnv ; /* environment variables values for transaction */ 

char *txnContent ; /* transaction's POST data content */ 

WRBEntry *WRBEntries ; 

int numEntries; 

vPosTCxp = (vPosTCtx *) clientCtx ; 

/* WRBGetURL gets the URL for the current request */ 

if (!(uri = WRBGetURL( WRBCtx ))) 

return (WRB_ERROR) ; 
/* WRBGetContent() gets the QueryString/POST data content */ 
if (!(txnContent = WRBGetContent( WRBCtx ))) { 

return WRB.ERROR ; 

} 

/* WRBGetParserContent() gets the parsed content */ 
if (WRB_ERROR == WRBGEtParsedContent( WRBCtx, &WRBEntries, 
&numEntries)) { 

return WRB_ERROR ; 

7«t 
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/* WRBGetEnvironment() gets the HTTP Server Environment */ 
if (!(txnEnv = WRBGetEnvironment( WRBCtx ))) { 
return WRB_ERROR ; 

} 

/* VPosTGetMethod() gets the method for the "current request */ 
if (! (method = VPosTGetMethod( txnEnv ))){ 
return (WRB_ERROR) ; 

} 

/* VPosTGetTxnQ gets the VPosT transaction for the request */ 
txn = VPosTGetTxn( uri ); 
if (eTxnError == txn) { 

return (WRB_ERROR) ; 

} 

/* VPosTExecuteTransaction() executes the VPosT transaction */ 
txnOutFile = VPosTExecuteTransaction( WRBCtx, txn, txnMethod, 

txnEnv, txnContent ) ; 
if (! (txnOutFile)) { 

return (WRB_ERROR) ; 

} 

/* Write out the file */ 
VPosTWriteFile( txnOutFile ) ; 
return (WRB.DONE) ; 
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VPosTG tTxn() 



enum eVPosTTxn 
VPosTGetTxn( char *uri ) 



{ 



10 } 



/* 

* The function scans the uri and extracts the string 

* corresponding to the transaction and returns it to the 

* caller. 
7 



Transaction Log format 

This section describes the format of a record for the transaction log for the 
VPosT cartridge. 



Field Name 



Field Description 



nTransType 

nPurchOrderNo 

szAcctNum 

szExpDate 

szTransAmt 

S2TransDate 

szTransTime 

szRetrievalRefN 
um 

szAuthld 



Transaction Type 

Purchase Order Number 

Payment Instrument Account number 

Payment instrument expiration date 

Transaction amount 

Date of transaction (configurable to be mm/dd/yy or 
dd/mm/yy) 

Time of transaction (configurable to be GMT or local 
time) 

Retrieval reference number 



Authorization ID 
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szOrigAmt Original transaction amount 

szBatchNum Batch number to which this particular transaction 

belongs in the VPoST batch 
nCurrencyType - Currency 
InTransNum Transaction number 



In the block diagram shown in Figure 15B, the VPOS provides an interface 
for transactions which are initiated both by the consumer and the 
5 merchant. The merchant initiates a transaction from a Graphical User 
Interface (GUI) 1550 and all the transactions that are initiated by the 
consumer are routed by the Merchant WEB Server 1545. 

The Authorization /Data Capture Module 1560 processes the requests 
10 originated by the merchant or the consumer and routes them to the Protocol 
Module 1565. The Protocol Module is responsible for building the payment 
protocol request packet (e.g., an SSL-encapsulated ISO 8583 packet) 1570 
before sending the request to the Gateway 1579. Then, the Gateway 1579 
awaits a response from the Protocol Module 1565, and upon receiving the 
15 response, the Gateway 1579 parses the data and provides unwrapped data 
to the Authorization/ Data-Capture Module 1560. The Authorization/ Data- 
Capture Module 1560 analyzes the response and updates the Transaction 
Log 1580. The Transaction Log 1580 contains information concerning any 
successfully completed transactions and the accumulators or the 
20 transaction totals. The VPOS terminal creates and maintains the 

Transaction Log 1580, and the VPOS Configuration Data 1585 contains 
information which is used to configure the behavior of the VPOS. 

77 
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The entire VPOS functionality is thread-safe and hence using the VPOS in a 
multi-threaded environment does not require any additional interfacing 
requirements. 

Payment Functionality 

As discussed above, the different Payment Functionality provided by the 
VPOS terminal can be divided into two main categories as "Merchant 
Initiated" and "Consumer Initiated." Some of these transactions require 
communication with the Gateway and these transactions are referred to as 
"Online Transactions." The transactions which can be done locally to the 
merchant without having to communicate are referred to as "Local 
Functions/Transactions." In order to provide support for many different 
types of Payment Instruments, the VPOS Payment Functionality have been 
categorized. 

Host payment functionality and transactions require communication with 
the host either immediately or at a later stage. Each of the host financial 
payment transactions come to this category and require a Payment 
20 Instrument. These transactions can be initiated with different types of 
Payment Instruments which the VPOS terminal supports. 

An authorization without capture transaction is used to validate the card 
holder's account number for a sale that needs to be performed at a later 
25 stage. The transaction does not confirm a sale's completion to the host, and 
there is no host data capture in this event. The VPOS captures this 
transaction record and later forwards it to the host to confirm the sale in a 

forced post transaction request. An authorization without capture 

transaction can be initiated both by the consumer and the merchant. 

it 



10 



" WO 98/37675 



PCT/US98/03236 



A forced post transaction confirms to a host computer that a completion of a 
sale has been accomplished and requests data capture of the transaction. 
The forced post transaction is used as a follow-up transaction after doing an 
5 authorization (Online or Off-line) transaction. The transaction can be 
initiated only by the merchant. 

The authorization with post transaction is a combination of authorization 
without capture and forced post transactions. This transaction can be 
10 initiated both by the consumer and the merchant. 

The offline post transaction is identical to the "authorization without 
capture" transaction, except that the transaction is locally captured by the 
VPOS without initiating communication with a host. A forced post operation 
15 is done as a follow-up operation of this transaction. This transaction can be 
initiated by both the consumer and the merchant. 

The return transaction is used to credit the return amount electronically to 
the consumer's account when a purchased merchandise is returned. The 
20 VPOS captures the return transaction record when the merchandise is 
returned, and this transaction can be initiated only by the merchant. 

The void transaction cancels a previously completed draft capture 
transaction. The VPOS GUI provides an interface for retrieving a transaction 
25 record required to be voided from the batch and passes it to the 

Authorization/ Data-Capture module after confirmation. The batch record is 
updated to reflect the voided transaction after getting an approval from the 
gateway. This transaction _can.be initiated only by the merchant. 
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The pre-authorization transaction is identical to the authorization without 
capture transaction, but the consumers' "open-to-buy" amount is reduced 
by the pre-authorization amount. An example of this type of transaction is 
the a check-in" transaction in a hotel environment. A check-in transaction 
5 sends a pre-authorization request to the host, so that an amount required 
for the customers' stay in the hotel is reserved. The pre-authorization 
transaction is followed by a pre-authorization complete transaction. This 
transaction can be initiated both by the consumer and the merchant. 

10 The pre-authorization complete transaction is done as a follow-up to the pre- 
authorization transaction. This transaction informs the host of the actual 
transaction amount. The pre-authorization complete transaction amount 
could be more or less than the pre-authorization amount. An example is the 
"check-out" transaction in a hotel environment. The check-out amount can 

15 be less than or more than the check- in amount. This transaction can only 
be initiated by a merchant. 

The adjust transaction is initiated to make a correction to the amount of a 
previously completed transaction. The adjust transaction can be initiated 
20 only by the merchant. The host administrative transactions do not require 
any payment instrument. The balance inquiry transaction is used for on- 
line inquiry into the balance of the merchant's account. The batch data or 
the configuration data is not affected by this transaction. 

25 The reconciliation or close transaction is processed at the end of the day to 
start the settlement process for the transactions captured by the host for 
that particular VPOS. 
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The host log-on transaction is an administrative transaction which is used 
to synchronize the VPOS with the host at the start of the day and also 
initiate a fresh batch at the VPOS terminal. 

5 The parameters download transaction is used to download the VPOS 

configuration information from the host and set-up the VPOS in the event of 
any change in the configuration data. A test transaction is used to detect 
the presence of a host and the status of a link from the VPOS to the host. 

10 Local transactions or functions are initiated by a merchant and do not 
require communication with the gateway. These transactions can only be 
initiated by a merchant. The totals or accumulators review is a local 
information inquiry function and is used to retrieve the local (merchant's) 
totals. The detail transaction or the batch review function is used to retrieve 

15 all the records from the transaction log or the batch. The clear batch 
function is used to start a fresh batch. This transaction is utilized to 
electronically reconcile the VPOS with the host and to manually reconcile 
the VPOS with the host. After completing the manual reconciliation 
processing, the merchant can initiate this transaction to start a fresh batch. 

20 

The clear accumulator function is similar to the clear batch functionality 
and resets all VPOS terminal accumulators to zero. This function is 
required when the merchant is not able to. reconcile the VPOS with the host 
electronically. 

25 

The VPOS unlock or start transaction is a local function used to start the 
VPOS at the start of the day. The VPOS lock or stop function is used to 

Lock or stop the VPOS from accepting any transactions. The VPOS 

configuration setup function is used to setup the VPOS configuration data. 
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The VPOS configuration data is divided into different tables, for example, the 
Card/Issuer Definition Table (CDT), the Host/Acquirer Definition Table 
(HDT), the Communications Parameters Table (CPT) and the Terminal 
Configuration Table (TCT). The following sections explain each of these 
5 configuration tables in detail. 



Host Definition Table (HDT) 

The table contains information specific to the acquirer. 



Field 


Attributes 
/ 

Bytes 


Field Description/ Comments 






Terminal 
Identifier 


ANS(20) 


Terminal ID for this acquirer/ host 


Merchant 
Identifier 


ANS(20) 


Merchant ID for this acquirer/ host 


Current Batch 
Number 


N(6) 


Batch Number for the batch currently 
existing on the VPOS 


Transaction 
Number 


1(2) 


Reference Number for next transaction 
in the VPOS transaction log/ batch 
(VPOS generated) 


TPDU 


AN(10) 


Transport Protocol Data Unit - Required 
for building the ISO 8583 packet. 


STAN 


L(4) 


Systems Trace Number - Message 
Number of the transaction to be 
transmitted next for this acquirer. 


Nil 


N(3) 


Network International Identifier - 
Required for building the ISO 8583 
packet. ~ 
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Host Name or 
Label 


ANS(20) 


Name for identifying the host, e.g., 
"AMEX-SIN". This is only a text string 
and is used for the purpose of 
identifying the host. 


No. of advice 
messages 


1(2) 


No. of off-line transactions (advice 
messages) that can be piggy-backed at 
the end of an on-line transaction. If set 
to zero then piggy-backing is disabled. 



The following fields specify whether Data Capture Required for a particular 
transaction for this acquirer. 



Viol A 


AtUlDULCS 

/ 

Bytes 


ITi**1fl Hpcrr in+irYn / C!rtTriT¥if»Tit«s 






Host Protocol 
Type 


1(2) 


Host Protocol type, e.g., ISO 8583, SET, 
etc., 


Host Protocol 
Sub-Type 


1(2) 


Sub protocol type, e.g., AMEX-IS08583, 
MOSET, etc., 


Auth Only DC 
Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Auth Capture 
DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Adjust DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Refund DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Cash Advance 
DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Cash Back DC 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 
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Flag 






Off-line Auth 
DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Void DC Flag - 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Pre-Auth DC 
Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Pre-Auth 
Complete DC 
Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Card Definition Table (CDT) 

This table contains information which are specific to the card issuer. 


Field 


Attributes 
/ 

Bytes 


Field Description/ Comments 






Host Index 


1(2) 


Index into the HDT or the acquirer 
which maps to this card issuer. 


PAN Low Range 


N(19) 


Low end of the PAN range . 


PAN High 
Range 


N(19) 


High end of the PAN range. 


Minimum PAN 
digits 


1(2) 


The minimum number of digits in the 
PAN for this acquirer. 


Maximum PAN 
digits 


1(2) 


The maximum number of digits in the 
PAN for this acquirer. 


Card Label 


ANS(20) 


Card Issuer Name for identification, 
e.g., VISA. 
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The following fields specify whether a particular transaction is allowed for a 
card range. 



Field 

- 


Attributes 
/ 

Bytes 


Field Description/ Comments 


Auth Only 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Auth Capture 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Adjust Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Refund Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Cash Advance 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Cash Back 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Off-line Auth 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Void Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Pre-Auth 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Pre-Auth 
Complete 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 



Communications Parameter Table (CPT) 

This table contains communications parameters information specific to an 
acquirer. The HDT and this table have a one-to-one mapping between them. 



WO 98/37675 




PCT/US98/03236 


Field 


Attributes 

/ 

Bytes 


Field Description/ Comments 






Primary 
Address 


AN(IOO) 


Primary Host Address (Telephone 
number, IP address, etc.) 


Secondary 
Address 


AN(IOO) 


Secondary Host Address to be used if 
the Primary Address is busy or not 
available. 


Tertiary 
Address 


AN(IOO) 


Tertiary Host Address. 


Response Time- 
out 


1(2) 


Time-out value (in seconds) before 
which the VPOS should receive a 
response from the host. 


Terminal Configuration Table (TCT) 

This table contains information specific to a particular VPOS terminal. 


Field 


Attributes 
/ 

Bytes 


Field Description/ Comments 






Merchant Name 


ANS(IOO) 


Name of the merchant having the VPOS 
terminal. 


VPOS Lock Flag 


Bit (1 bit) 


1 = VPOS Locked, 0 « VPOS Unlocked 



5 

Payment Instruments 

As discussed above, the VPOS terminal supports different Payment 
Instruments and each of the Payment Functions described above can be 
initiated by these different Payment Instruments. "The consumer making a 
10 purchase from a merchant provides a choice of payment methods depending 
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upon their personal preference. The Payment Instrument Class Hierarchy 
which is used by the different VPOS terminal Payment Functions is 
described below. 

5 Message Sequence Diagram 

Figure 17 shows a typical message flow between the consumer, merchant, 
VPOS terminal and the Gateway. This section describes the different classes 
listed in the previous section, their data and members, and defines the type 
of the transaction that is to be performed. Processing commences at 1700 
10 when a merchant server receives a sales order and passes it via the VPoS 
Graphical User Interfece (GUI) 1710 to an authorizer 1720 for approval and 
subsequent protocol processing 1730 and ultimately transmission via the 
gateway 1740 to the network. 

15 Class Name : 

CVPCLTransaction 
Data : 

Transaction Type (int) 

Transaction Date and Time (CPCLDateTime) 
20 Card Definition Table (CVPCL.CDT) 

Host Definition Table (CVPCL_HDT) 

Communications Parameters Table (CVPCL_CPT) 

Terminal Configuration Parameters (OVPCLTCT) 

Batch Record (CVPCLBatch) 
25 Accumulator Record (CVPCLAccum) 
Member Functions : 

CVPCLTransaction() ; 

EStatu s GetTransType() ; 

EStatus GetTransDateTime(CPCLDateTime86) ; 
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EStatus SetTransType(const int); 

virtual EStatus InitializeTrans(TVPosParamsBlk *) = 0; 
virtual EStatus ExecuteTrans(TVPosResultsBlk *) = 0; 
virtual EStatus ShutDown() = 0; 

5 

Host Transaction Class Definitions 

This section contains all the host transaction class definitions. 

Host Transaction Class (CVPCLHostTrans) 

10 This is an abstract base class derived from the CVPCLTransaction class and 
is used for deriving transaction classes which need to communicate with the 
host either immediately or at a later stage. 



Class Name : 
15 CVPCLHostTrans 
Data : 

Member Functions : 

CVPCLHostTransO; 

20 

Financial Transaction Class (CVPCLFinancialTrans) 

This is an abstract base class derived from the CVPCLHostTrans. This class 
is used to derive transaction classes which, require a payment instrument 
(e.g., a Credit Card) associated with them to perform the transaction. 

25 

Class Name : 

CVPCLFinancialTrans 

Data : 

Transaction Amount (CVPCLAmt) 
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Purchase Order Number (char[]]) 
Transaction Number (char[]) 
Authorization Identification Number (char[]) 
Retrieval Reference Number (char[]) 
Batch (CVPCLBatch) 
Accumulators (CVPCLAccumulators) 
Member Functions : 

CVPCLFinancialTrans() ; 
EStatus GetTransAmt(CVPCLAmt&); 
EStatus GetPurchOrderNum(char *); 
EStatus GetTransRefNum(char *); 
EStatus GetRetRefNum(char *); 
EStatus GetAuthId(char *); 
EStatus GetCurrencyType(EPCLCurrency *); 
EStatus SetPurchOrderNum(const char *); 
EStatus SetTransRefNum(const char *); 
EStatus SetRetRefNum(const char *); 
EStatus SetAuthId(const char *); 
EStatus SetCurrencyType (const char *) 

Financial Credit Card Transaction Class (CVPCLFinCCTrans) 

This is the base abstract class for the financial host transaction which 
require a Credit Card payment instrument. This class is derived from the 
CVPCLFinancialTrans. 

Class Name : 

CVPCLFinCCTrans 

Data : 

6°! 
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Credit Card Payment Instrument (CPCLCreditCard) 

Member Functions : 

CVPCLFinCCTrans() ; 

5 

Credit Card Authorization Only Transaction Class (CVPCL_CCAuthOnly) 

This is the class derived from the CVPCLFinCCTrans class and implements 
the Authorization Only Transaction. 

10 

Class Name : 

CVPCL_CCAuthOnly 
Data : 

1 S Member Functions : 

CVPCL_CCAuthOnly() ; 
EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTransfTVPosResultsBlk *); 
EStatus ShutDownTrans(); 
20 EStatus FormBatchRec(); 

Credit Card Authorization with Capture Transaction Class 
|CVPCL_CCAuthCapt) 

This is the class derived from the CVPCLFinCCTrans class and implements 
25 the Authorization with Data Capture Transaction. 

Class Name : 

CVPCLCCAuthCapt 

Data : 

to 
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Member Functions : 

CVPCL_CCAuthCapt() ; 
EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
5 EStatus ShutDownTrans(); 

EStatus FormBatchRecQ; 

Credit Card Return Transaction Class (CVPCL_CCReturn) 

This is the class derived from the CVPCLFinCCTrans class and implements 
10 the Return Transaction. 

Class Name : 

CVPCL_CCReturn 
Data : 

15 

Member Functions : 

CVPCL_CCReturn(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
20 EStatus ShutDownTrans(); 

EStatus FormBatchRec(); 

Credit Card Pre-Authorization Transaction Class (CVPCL_CCPreAuth) 

This is the class derived from the CVPCLFinCCTrans class and implements 
25 the Pre-Authorization Transaction. 



Class Name : 

CVPCL_CCPreAuth 

Data : 



V 



WO 98/37675 



PCT/US98/03236 



Member Functions : 

CVPCL_CCPreAuth(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 
EStatus FormBatchRec(); 

Credit Card Off-line Authorization Only Transaction Class 
(CVPCL.CCOfOineAuth) 

This is the class derived from the CVPCLFinCCTrans class and implements 
the Offline Authorization Class Transaction. 
Class Name : 

CVPCL_CCOfflineAuth 
Data : 

Member Functions : 

CVPCL_CCOfflineAuth() ; 

EStatus InitializeTrans(TVPosParamsBlk *); 

EStatus ExecuteTrans(TVPosResultsBlk *); 

EStatus ShutDownTrans(); 

EStatus FormBatchRec(); 

Credit Card Adjust Transaction Class (CVPCL_CCAdjust) 

This is the class derived from the CVPCLFinCCTrans class and implements 
the Adjust Transaction. 

Class Name : 

CVPCL_CCAdjust 

Data : 



WO 98/37675 



PCT/US98/03236 



Member Functions : 

CVPCL_CCAdjust(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
5 EStatus ExecuteTrans(TVPosResultsBlk *); 

EStatus ShutDownTrans(); 
EStatus FormBatchRec(); 

10 Credit Card Void Transaction Class (CVPCL_CCVoid) 

This is the class derived from the CVPCLFinCCTrans class and implements 
the Void Transaction. 

Class Name : 
15 CVPCL_CCVoid 
Data : 

Member Functions : 

CVPCL_CCVoid(); 
20 EStatus InitializeTrans(TVPosParamsBlk *); 

EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 
EStatus FormBatchRec(); 

25 Credit Card Forced Post Transaction Class (CVPCL_CCForcedPost) 

This is the class derived from the CVPCLFinCCTrans class and implements 
the Forced Post Transaction. 



Class Name : 
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CVPCL_CCForcedPost 
Data : 

Member Functions : 

5 CVPCL_CCForcedPost(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
. EStatus ShutDownTrans(); 
EStatus FormBatchRec(); 

10 

Pre-Authorization Complete Transaction Class 
(CVPCL_CCPreAuthComp) 

This is the class derived from the CVPCLFinCCTrans class and implements 
the Pre-Authorization Completion Transaction. 

15 

Class Name : 

CVPCL_CCPreAuthCpmp 
Data : 

20 Member Functions : 

CVPCL_CCPreAuthComp() ; 
EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 
25 EStatus FormBatchRec(); 

Credit Card Balance Inquiry Class (CVPCL_CCBalanceInq) 

This class is derived from the CVPCLFinCCTrans class and is used Jo 

perform the Merchant Balance Inquiry function. 
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Class Name : 

CVPCL_CCBalan elnq 
Data : 

5 

Member Functions : 

CVPCL_CCBalanceInq() ; 
EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
10 EStatus ShutDownTrans(); 

Administrative Host Transaction Class (CVPCLAdminHostTrans) 

This is an abstract base class derived from the CVPCLHostTrans class and is 
used to derive the administrative host transaction classes. 

15 

Class Name : 

CVPCLAdminHostTrans 
Data : 



20 Member Functions : 

CVPCLAdminHostTrans(); 

int GetHostIndex(); 

EStatus SetHostlndex (const int); 

25 Reconcile Transaction Class (CVPCLReconcile) 

This is the class derived from the CVPCLAdminHostTrans class and 
implements the Reconcile or Close functionality. 

Class Name : 

CVPCLReconcile 



is 
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Data : 

Member Functions : 

CVPCLReconcile(); 
5 EStatus InitializeTrans(TVPosParamsBlk *); 

EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

Host Log-on Transaction Class (CVPCLHostLogon) 

10 This is the class derived from the CVPCLAdminHostTrans class and 
implements the Host Log-on Transaction. 

Class Name : 

CVPCLHostLogon 
15 Data : . , . 

Member Functions : 

CVPCLHostLogon(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
20 EStatus ExecuteTransfTVPosResultsBlk *); 

EStatus ShutDownTrans(); 

Parameters Download Transaction Class (CVPCLParamsDwnld) 

This is the class derived from the CVPCLAdminHostTrans class and 
25 implements the Parameters Download (VPOS configuration information from 
the host) functionality. 

Class Name : 

CVPCLParamsDwnld 
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Data : 

Memb r Functions : 

CVPCLParamsDwnld() ; 
5 EStatus InitializeTrans(TVPosParamsBlk *); 

EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

Test Transaction Class (CVPCLTestHost) 

10 This is the class derived from the CVPCLAdminHostTrans class and • 
implements the Test functionality which is used to test the host and the 
link. 

Class Name : 
15 CVPCLTestHost 
Data : 

Member Functions : 

CVPCLTestHost(); 
20 EStatus InitializeTrans(TVPosParamsBlk *); 

EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

Local Transaction Class Definitions (CVPCLLocalTrans) 

25 This is the abstract base class for all the transactions that are performed 
locally to the VPOS. 

Class Name : 

CVPCLLocalTrans 
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Data : 

Record Number (int) 
Host Index (int) 
Member Functions : 

5 CVPCLocalTrans(); 

int GetRecNumQ; 

int GetHostIndex() 

EStatus SetRecNum(const int); 

EStatus SetHostIndex(const int); 

10 

Virtual POS Lock/ Stop Class (CVPCLVPosLock) 

This class implements the VPOS Lock or the Stop Local functionality. Under 
the locked state the VPOS does not accept any transaction requests. The 
15 class is derived from the CVPCLLocalTrans base class. 
Class Name : 

CVPCLVPosLock 

Data : 

Member Functions : 

20 CVPCLVPosLock(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

25 Virtual POS UnLock/Start Class (CVPCLVPosUnlock) 

This class implements the VPOS UnLock or the Start Local functionality. The 
class is derived from the CVPCLLocalTrans base class. 

Class Name : 

ft 
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CVPCLVPosUnLock 

Data : 

Member Functions : 

5 CVPCLVPosUnlock(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

10 Transaction Data Administration Class (CVPCLTransDataAdmin) 

This is an abstract base class used to derive the classes which are required 
to review/ manage the transaction data which includes the batch data and 
the accumulator data. The class is derived from the CVPCLLocalTrans base 
class. 

15 

Class Name : 

CVPCLTransDataAdmin 

Data : 

Member Functions : 

20 CVPCLTransDataAdminQ; 

Batch Review Class (CVPCLBatchReview) 

This class is derived from the CVPCLTransDataAdmin base class and 
implements the batch review functionality 
25 Class Name : 

CVPCLBatchReview 

Data : 

Member Functions : 
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CVPCLBatchReview() ; 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

5 

Clear Batch Class (CVPCLClearBatch) 

This class is derived from the CVPCLTransDataAdmin base class and 
implements the clear batch functionality, which is used to clear the batch in 
the event of doing a manual reconciliation between the VPOS and the 
1 0 acquirer. 

Class Name : 

CVPCLClearBatch 

Data : 

1 5 Member Functions : 

CVPCLClearBatch(); 

EStatus InitializeTrans(TVPosParamsBlk *) ; 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

20 

Accumulators Review Class (CVPCLAccumReview) 

This class is derived from the CVPCLTransDataAdmin base class and 
implements the Accumulators Review functionality. 
Class Name : 
25 CVPCLAccumReview 
Data : 

Member Functions : 

CVPCLAccumReviewQ; 

EStatus InitializeTrans(TVPosParamsBlk *); 

[oo _ 
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EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

Clear Accumulators Class (CVPCLClearAccum) 

5 This class is derived from the CVPCLTransDataAdmin base class and 
implements the Accumulators Clear functionality. 

Class Name : 

CVPCLClearAccum 

10 Data : 

Member Functions : 

CVPCLClearAccumQ ; 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
15 EStatus ShutDownTrans(); 

VPOS Configuration Data Administration Class 
(CVPCLConfigDataAdmin) 

This is an abstract base class and is used to derive classes which implement 
20 the functionality for managing the VPOS configuration data. The class is 
derived from the CVPCLLocalTrans base class. 

Class Name : 

CVPCLConfigDataAdmin 

25 Data : 

Member Functions : 

Acquirer Data or the Host Definition Table Review Class 
(CVPCL_HDTReview) 



|0( 
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This class is derived from the CVPCLConfigDataAdmin class and implements 
the Host Definition Table Review functionality. 

Class Name : 
5 CVPCL_HDTReview 
Data : 

Member Functions : 

CVPCL_HDTReview(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
10 EStatus ExecuteTrans(TVPosResultsBlk *); 

EStatus ShutDownTrans(); 

Issuer Data or the Card Definition Table Review Class 
(CVPCL_CDTReview) 

15 This class is derived from the CVPCLConfigDataAdmin class and implements 
the Card Definition Table Review functionality. 
Class Name : 

CVPCL_CDTReview 

Data : 

20 Member Functions : 

CVPCL_CDTReview(); 



EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
25 EStatus ShutDownTrans(); 

Communication Parameters Table Review Class (CVPCL_CPTReview) 

This class is derived fromjthe CVPCLConfigDataAdmin class and implements 
the Communications Parameters Table Review functionality. 



I by 
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Class Name : 

CVPCL_CPTReview 

Data : 

5 

Member Functions : 

CVPCL_CPTReview(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
10 EStatus ShutDownTrans(); 

Terminal Configuration Table Review Class (CVPCL_TCTReview) 

This class is derived from the CVPCLConfigDataAdmin class and implements 
the Terminal Configuration Table Review functionality. 

15 

Class Name : 

CVPCLjrCTReview 

Data : 

20 Member Functions : 

CVPCL_TCTReview(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
25 EStatus ShutDownTrans(); 

Acquirer Data or the Host Definition Table Update Class 

(CVPCLHDTUpdate) 



\03 
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This class is derived from the CVPCLConfigDataAdmin class and implements 
the Host Definition Table Update functionality. 
Class Nam : 

CVPCL.HDTUpdate 

5 Data : 

Member Functions : 

CVPCLHDTUpdate(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
10 EStatus ShutDownTrans(); 

Issuer Data or the Card Definition Table Update Class 
(CVPCL_CDTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements 
15 the Card Definition Table Update functionality. 
Class Name : 

CVPCL_CDTUpdate 

Data : 

Member Functions : 

20 CVPCL_CDTUpdate(); 

EStatus lnitiaJizeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

25 Communications Parameters Table Update Class (CVPCL_CPTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements 
the Communications Parameters Table Update functionality. 



Class Name : 
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CVPCL.CPTUpdate 

Data : 

Member Functions : 

CVPCL_CPTUpdate(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

Terminal Configuration Table Update Class (CVPCL_TCTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements 
the Terminal Configuration Table Update functionality. 

Class Name : 

CVPCL_TCTUpdate 

Data : 

Member Functions : 

CVPCL_TCTUpdate(); 

EStatus InitializeTrans(TVPosParamsBlk *); 
EStatus ExecuteTrans(TVPosResultsBlk *); 
EStatus ShutDownTrans(); 

Batch Class (CVPCLBatch) 

This class defines the batch record and the operations which are performed 
on the batch. 

Class Name : 

CVPCLBatch 

Data : 
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10 



Batch Record Structure (TVPosBatchRec) 
// Definition of the TVPosBatchRec is as below, 
typedef struct JVPosBatchRec 



{ 



the host 



host 



Adjust 



char s2TransAmt[]; 

char S2TransDate[]; 

char s2TransTime[]; 

char szRetrievalRefNum[]; 

char szAuthId[]; 

char szOrigAmt[]; 



// Trans. Ref. No. sent by 
/ / Approval Code sent by the 
/ / Original amount for - 



char szPurchOrderNum[]; 
15 char szBatchNum[]; 

EPCLTransType TransType; 

EPCLPmtlnst Pmtlnst; 

EPCLCurrency CurrencyType; 

EPCLDecimals NumDecDigits; 
20 unsigned int nTransRefNum; / / Running Ref. Number gen. 

by the / / VPOS for every 

approved txn. unsigned long InSTAN; // Sys. 

Trace Number incr. by VPOS 

/ / for every trans, that is 

25 trans, to host 

TPmtlnstData PaylnstData; 
} TVPosBatchRec; 

Mem ber Functions : 

CVPCLBatchQ; 
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EStatus SetTransType(const EPCLTransType); 

EStatus SetRetRefNum(const char *); 

EStatus SetAuthId(const char *); 

EStatus SelPurchOrderNum(const char *); 
5 EStatus SetTransRefNum(const long); 

. EStatus SetTransAmt(const char *); 

EStatus SetBatchNurn(const char *); 

EStatus SetSTAN(const long); 

EStatus SetDateMMDDYYYY(const char *); 
10 EStatus SetTimeHHMMSS{const char *); 

EStatus SetPmtInst(const EPCLPmtlnst); 

EStatus SetCCAcctNum(const char *); 

EStatus SetCCExpDate(const char *); 

EStatus SetOrigAmt(const char *); 
15 EStatus GetBatchRec(TVPosBatchRec *); 

EStatus InitBatch(); 

EStatus OpenBatch(const char *, FILE **, const char *); 
EStatus CloseBatch(FILE *); 

EStatus AddBatchRec (); / / Adds a record to the 

20 batch 

EStatus GetBatchRec (const long); / / Gets a record from the 

batch 

EStatus UpdateBatchRec (const long); // Update batch record 
with NR 

25 EStatus DeleteBatchRec (const long); // Deletes the batch record 

Accumulator Class (CVPCLAccum) 

This class defin es th e Accumulator record and the operations on the 
accumulators. 
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Class Name : 

CVPCLAccum 

Data : 

Credit Amount (char szCreditAmt[AMT_SZ + 1]) 
5 Credit Count (int nCreditCnt) 

Debit Amount (char szDebitAmt[AMT_SZ + 1) 

Debit Count (int nDebitCnt) 
Member Functions : 

int OpenAccum(int fHandle); 
10 int GetAccum (int nAccumType, int *pnAccumCnt, char 

*pszAccumAmt); 

int CloseAccum(int fHandle); 

int CleanAccum(); 

15 Host Definition Table Class (CVPCL_HDT) 

This class defines the Host Definition Table record and the operations on the 
table. 

Class Name : 

CVPCL^HDT 

20 Data : 

Host Definition Table Record Structure (TVPosHDTRec ) 
The TVPosHDTRec structure contains the following fields, 

typedef struct _VPosHDTRec 

{ 

25 char s^TermId[]; 

char szMerchId[]; 
char szBatchNum[]; 

char szTPDU[]; . 

char szNII[]; 
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char szHostName[]; 
EPCLHostProtType HostProtType; 
EPCLHostProtSubType HostProtSubType; 
// Data Capture Required Flags 
5 VPosBool fAuthOnlyDC; 

VPosBool fAuthCaptDC; 
VPosBool fForcedPostDC; 
VPosBool fAdjustDC; 
VPosBool fReturnDC; 
10 VPosBool fOfflineAuthDC; 

VPosBool fVoidDC; 
VPosBool fPreAuthDC; 
VPosBool fPreAuthCompDC; 

unsigned int nNumAdv;// Max. No. of piggy-back trans. 

15 allowed 

unsigned int nTransRefNum; 

unsigned long InSTAN; // Systems Trace Number 
} TVPosHDTRec; 

20 Member Functions : 

CVPCL_HDT(); 
EStatus CleanHDT(); 
EStatus LoadHDTRec(const int); 
EStatus SaveHDTRec(const int); 
25 EStatus GetNumRecs(int *); 

EStatus GetHDTRecfTVPosHDTRec *); 
EStatus GetTermId(char *); 

EStatus GetMerchId(char *); 

EStatus GetBatchNum(char *); 
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EStatus GetTransRefNum(unsigned int *); 

EStatus GetTPDU(char *); 

EStatus GetNII(char *); 

EStatus GetHostName(char *); 

EStatus GetHostProtType(EPCLHostProtType *); 

EStatus GetHostProtSubType(EPCLHostProtSubType *); 

EStatus GetNumAdv(unsigned int *); 

EStatus GetSTAN(unsigned long *); 

EStatus GetAuthOnlyDC(VPosBool *); 

EStatus GetAuthCaptDC(VPosBool *); 

EStatus GetAdjustDC(VPosBool *); 

EStatus GetReturnDC(VPosBool *); 

EStatus GetForcedPostDC(VPosBool *); 

EStatus GetOfflineAuthDC(VPosBool *); 

EStatus GetVoidDC(VPosBool *); 

EStatus GetPreAuthDC(VPosBool *); 

EStatus GetPreAuthCompDC(VPosBool *); 

EStatus SetHDTRecfTVPosHDTRec *); 

EStatus SetTermId(const char *); 

EStatus SetMerchId(const char *); 

EStatus SetBatchNum(const char *); 

EStatus SetTransRefNum(const unsigned int); 

EStatus SetTPDU(const char *); 

EStatus SetSTAN(const unsigned long); 

EStatus SetNII(const char *); 

EStatus SetHostName(const char *); 

EStatus SetHostProtType(const EPCLHostProtType); 

EStatus SetHostProtSubT^pe(const EPCLHostProtSubType); 

EStatus SetNumAdv(const int); 

\\0 
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EStatus SetAuthOnlyDC(const VPosBool); 
EStatus SetAuthCaptDC(const VPosBool); 
EStatus SetAdjustDC(const VPosBool); 
EStatus SetReturnDC(const VPosBool); 
EStatus SetForcedPostDC(const VPosBool); 
EStatus SetOfflineAuthDC(const VPosBool); 
EStatus SetVoidDC(const VPosBool); 
EStatus SetPreAuthDC(const VPosBool); 
EStatus SetPreAuthCompDC(const VPosBool); 



Card Definition Table Class (CVPCL.CDT) 

This class defines the Card Definition Table record and the operations on 
table. 

Class Name : 

CVPCL_CDT 

Data : 

Card Definition Table Record Structure (TVPosCDTRec ) 
The TVPosCDTRec structure contains the following fields, 
typedef struct _VPosCDTRec 

{ 

char szPANLo[); 

char szPANHi[J; 

char szCardLabel[]; 

int nHostlndex; 

int nMinPANDigit; 

int nMaxPANDigit; 

/ / Transaction Allowed Flags 

._. VPosBool fAuthOnlyAllwd; 

VPosBool fAuthCaptAllwd; 
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VPosBool fForcedPostAllwd; 
VPosBool fAdjustAllwd; 
VPosBool fReturnAllwd; 
VPosBool fOfflineAuthAllwd; 
VPosBool fVoidAllwd; 
VPosBool fPreAuthAllwd; 
VPosBool fPreAuthCompAllwd; 
} TVPosCDTRec; 

Member Functions : 

CVPCL_CDT(); 
EStatus CleanCDT(); 
EStatus LoadCDTRec(const int); 
EStatus SaveCDTRec(const int); 
EStatus GetNumRecs(int *); 
EStatus GetCDTRec(TVPosCDTRec *); 
EStatus GetPANLo(char *); 
EStatus GetPANHi(char *); 
EStatus GetCardLabel(char *); 
EStatus GetCDTHostIndex(int *); 
EStatus GetMinPANDigit(int *); 
EStatus GetMaxPANDigit(int *); 
EStatus GetAuthOnlyAllwd(VPosBool *); 
EStatus GetAuthCaptAllwd(VPosBool *); 
EStatus GetAdjustAllwd(VPosBool *); 
EStatus GetReturnAllwd(VPosBool *); 
EStatus GetOfflineAuthAllwd(VPosBool *); 
EStatus GetVoidAUwdfVPosBool *); 
EStatus GetPreAuthAllwd(VPosBool *); 
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EStatus GetPreAuthCompAllwd(VPosBool *); 
EStatus GetForcedPostAllwd(VPosBool *); 
EStatus SetCDTRecfTVPosCDTRec *); 
EStatus SetHostIndex(const int); 
EStatus SetMinPANDigit(const int); 
EStatus SetMaxPANDigit(const int); 
EStatus SetPANLo(const char *); 
EStatus SetPANHi(const char *); 
EStatus SetCardLabel(const char *); 
EStatus SetAuthOnlyAllwd (const VPosBool); 
EStatus SetAuthCaptAllwd(const VPosBool); 
EStatus SetAdjustAllwd(const VPosBool); 
EStatus SetReturnAllwd(const VPosBool); 
EStatus SetForcedPostAllwd(const VPosBool); 
EStatus SetOfflineAuthAllwd(const VPosBool); 
EStatus SetVoidAllwd(const VPosBool); 
EStatus SetPreAuthAllwd(const VPosBool); 
EStatus SetPreAuthCompAUwd(const VPosBool); 

Communications Parameters Table Class (CVPCL_CPT) 

This class defines the communications parameters table and the operations 
on the table. 

Class Name : 

CVPCL.CPT 

Data : 

Communications Parameters Table Record Structure (TVPosCPTRec ) 
The TVPosCPTRec structure contains^the following fields, 
typedef struct _VPosCPTRec 
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char 



char 



char 



szAcqPriAddressf]; 

szAcqSecAddress[]; 

szAcqTerAddress[]; 



int 



nRespTimeOut; 



} TVPosCPTRec; 

Member Functions : 

CVPCL_CPT(); 

EStatus CleanCPT(); 

EStatus LoadCPTRec(const int); 

EStatus SaveCPTRec(const int); 

EStatus GetNumRecs(int *); 

EStatus GetCPTRecfTVPosCPTRec *) ; . 

EStatus GetAcqPriAddress(char *); 

EStatus GetAcqSecAddress(char *); 

EStatus GetAcqTerAddress(char *); 

EStatus GetRespTimeOut(int *); 

EStatus SetCPTRec(TVPosCPTRec *); 

EStatus SetAcqPriAddress(const char *); 

EStatus SetAcqSecAddress(con$t char *); 

EStatus SetAcqTerAddress(const char *); 

EStatus SetRespTimeOut(const int); 

Terminal Configuration Table Class (CVPCL_TCT) 

This class defines the VPOS terminal configuration parameters table and the 
operations on the table. 
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Class Name : 

CVPCL_TCT 

Data : 

Terminal Configuration Table Record Structure (TVPosTCTRec ) 
The TVPosTCTRec structure contains the following fields, 
typedef struct _VPosTCTRec 

{ 

char szMerchName[]; 

VPosBool fVPosLock; // VPOS Lock/Unlock Toggle 

Flag 

} TVPosTCTRec; 

Member Functions : 

CVPCLTCTO; 

EStatus LoadTCTRec(); 

EStatus SaveTCTRec(); 

EStatus CleanTCT(); 

EStatus GetTCTRec(TVPosTCTRec *); 

EStatus GetMerchName(char *); 

EStatus GetVPOSLock(VPosBool *); 

EStatus SetMerchName(const char *); 

EStatus SetVPOSLock(const VPosBool); 

Amount Class (CVPCLAmount) 

This class defines the amount data items and the operations on them. 

Class Name : 

CVPCLAmount 

Data : 

us 
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Amount (char[J) 



Currency Type (EPCLCurrency) 
Member Functions : 



CVPCLAmountQ; 



5 



EStatus Initialize(const CPCLAmount&); 
EStatus Initialize(const char *); 



EStatus Initialize(const long); 
void operators (const char *); 
void operator = (const long); 



10 



EStatus GetAmount(char *); 
operator const char * () const; 
operator const long (); 



Payment Instruments Class (CPCLPmtlnst) 

15 This section defines the Payment Instrument Class hierarchy. Figure 16 
illustrates a transaction class hierarchy in accordance with a preferred 
embodiment. 

Class Name : 
20 CPCLPmtlnst 
Data : 

Payment Instrument Type (EPCLPmtlnst) 
Member Functions : 
CPCLPmtInst(); 
25 EStatus GetPmtlnstType (EPCLPmtlnst *); 

Bank Cards Class (CPCLBankCard) 

Thi s class is derived from the CPCLPmtlnst class and implements the bank 
cards class. 
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Class Name : 

CPCLBankCard 

Data : 

5 Account Number (char[ ]) 

Expiration Date (CPCLDateTime) 
Index into the CDT table (int) 
Member Functions : 

CPCLBankCard(); 

10 

EStatus Initialize(); 

EStatus SetAcctNum(const char *); 

EStatus SetExpDate(const char *); 

EStatus GetAcctNum(char *); 
15 EStatus GetExpDate(char *); 

EStatus ValidateCard(); 

int GetCDTIndexQ; 

VPosBool DoLuhnCheck(); 

VPosBool DoCardRanging(); 
20 EStatus DoValidateExpDate(); 

Credit Cards Class (CPCLCreditCard) 

This class is derived from the CPCLBankCard class and has the same data 
and the methods as the CPCLBankCard class. 
25 Class Name : 

CPCLCreditCard 

Data : 

Member Functions : 
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CPCLCreditCard(); 

Debit Cards Class (CPCLDebitCard) 

This class is deriv.ed from the CVPCLBankCard class and implements the 
5 debit card class. 

Class Name : 

CPCLDebitCard 

Data : 

Card Holder Encrypted PIN (char[ ]) 
Member Functions : 

CPCLDebitCardQ; 
EStatus GetEncryptedPIN(char *); 
EStatus SetEncryptedPIN(char *); 



VPOS Class Library Interface and API Definition 

This section explains the classes which provide the interface to the VPOS 
class library. 

Data Structures required for the VPOS Interface Class 

Transaction Parameters Structure (TVPosParamsBlk) - This structure is a 
subset of all the transaction parameters required for the different 
transactions. 

typedef struct _VPosParamsBlk 
{ 

char s2TransAmt[]; // Without decimal point. 



we 



WO 98/37675 



PCT/US98/03236 



/ / Left most two digits implied to be decimal 

digits 

char szPurchOrderNum[]; 

char szRetRefNumf]; 
char szBatchNumf]; 

char szNewBatchNum[]; 

char szOrigAmt[]; 

char szCPSData[] ; 

char szAuthId[]; // Auth Id for offline auth-only 

transaction 

int Hostlndex; 

unsigned int nTransRefNum; 
VPosBool fVPosLock; 
ECPSDataType eCPSType ; 
EPCLTransType TransType; 
EStatus TransResult; 
EPCLPmtlnst Pmtlnst; 
EPCLCurrency CurrencyType; 
EPCLDecimals NumDecDigits; 
EVPCLAccumType AccumType; 
TPmtlnstData PaylnstData; 
union _VPosConfigData 

{ 

TVPosHDTRec srHDTRec; 
TVPosCDTRec srCDTRec; 
TVPosCPTRec srCPTRec; 
TVPosTCTRec srTCTRec; 

} VPosConfigData; 

void *Context; // Context from the calling interface 
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EStatus (*VPosCallBack) (TVPosResultsBlk *, void *); 
} TVPosParamsBlk; 

5 Transaction Results Structure (TVPosResultsBlk) - This structure contains 
all the fields returned from the host and other fields which are required for 
doing terminal data capture. 

typedef struct _VPosResultsBlk 
10 { 

char szNewBatchNumfl; 

int nHostlndex; 

EStatus TransResult; 

TVPosBatchRec srBatchRec; 
15 TVPosAccumRec srAccumRec; 

char szCardLabel[]; 

TVPosHDTRec srHDTRec; 

TVPosCDTRec srCDTRec; 

TVPosCPTRec srCPTRec; 
20 TVPosTCTRec siTCTRec; 

} TVPosResultsBlk; 

The various status codes for the enumeration EStatus are detailed below. 

25 VPOS Interface Class (CVPosInterface) 

This class provides the interface to the VPOS Transaction Class Library. 
Class Name : 

CVPosInterface 

Data : 
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Memb r Functions : 

CVPosInterface(); 

/ / Creates the Transaction Object, takes care 
//of other initialization and executes the transaction. 
5 CVPCLTransaction *pclTransFactoiy(WPosParamsBlk *); 

EStatus DestroyTrans(CVPCLTransaction *); 

VPOS API Definition 

This section explains in the VPOS API which are required for interfacing with 
10 the VPOS Class Library. All the different VPOS transactions can be initiated 
using the API defined in this section, 

VPosInitialize - Initialize VPOS 

This API is used to start and initialize the VPOS. The API definition is 
15 disclosed below. 

API Definition : 

VPosBool VPosInitialize (void); 
Parameters : 
20 None 
Returns : 

TRUE or FALSE indicating whether the function call was a success. 

VPosExecute - Execute a VPOS Transaction 

25 This API is used to execute a particular VPOS transaction. 
API Definition : 

VPosBool VPosExecute(TVPosParamsBlk *, TVPosResultsBlk *) 
Parameters : _ 

Pointer to the Parameters Structure (TVPosParamsBlk) 
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.Pointer to the Results Structure (TVPosResultsBlk) 
Returns : 

TRUE or FALSE indicating whether the function call was a success. 

VPosShutDown - Shutdown the VPOS 

This is used to shutdown the VPOS. 
API Definition : 

VPosBool VPosShutDown(void) 
Parameters : 

None 
Returns : 

TRUE or FALSE indicating whether the function call was a success. 

VPOS Status Codes 

This section details the different status codes (listed under the enumeration 
EStatus) which the VPOS returns for the different operations performed, 
enum EStatus 

{ 

eSuccess = 0, / / Function call or operation successful 

eFailure, / / General failure 

eVPosLocked, / / Vpos locked, transaction not allowed 

// Transaction related error codes 

ePmtlnstNotSupported, / / Payment Instrument not supported 

eTransNotSupported, / / Transaction type not supported 

eTransInitErr, / / Transaction Initialization Failed 

eAdjustNotAllwd, // Adjust not allowed on this 
transaction 

_ e VoidN otAllwd, /_/. Void not allowed on this transaction 
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eForcedPostNotAllwd, / / Forced Post not allowed on this 

transaction 

ePreAuthCompNotAllwd, // Pre-Auth. not allowed on this 
transaction 

/ / Error in the amount passed 

/ / Error during loading the HDT table 
// Error during loading the CDT table 
/ / Error during loading the CPT 



5 eAmtErr, 

eHDTLoadErr, 
eCDTLoadErr, 
eCPTLoadErr, 
table 

10 eTCTLoadErr, 
table 

eHDTWriteErr, 

table 

eCDTWriteErr, 

15 table 

eCPTWriteErr, 
CPT table 

eTCTWriteErr, 
TCT table 
20 eTCTFieldErr, 
field 

eLuhnErr, 
eRangingErr, 
ePANLenErr, 
25 eExpiredCard, 
elnvalidMonth, 
eFileOpenErr, 
eFileCloseErr, 



/ / Error during loading the TCT 
/ / Error during writing to the HDT 
/ / Error during writing to the CDT 
/ / Error during writing to the 
/ / Error during writing to the 
// Error handling a TCT table 

/ / Luhn check failed on the account 
. / / Card range not found 
// PAN length error 
// Card expired 

/ / Invalid month in the expiration date 
// General file open error 
/ / General file close error 
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VPOS Terminal Architecture 

Figure 25 is a block diagram of the vPOS Terminal Architecture in 
accordance with a preferred embodiment. The Internet 2500 provides the 
communication processing necessary to enable the VPOS Terninal 

5 architecture. The terminal interface CGI 2520 communicates via the 

internet to provide information to the VPOS OLE Server 2550 which formats 
information in accordance with the VPOS API DLL 2560 which uses the 
protocol class DLL 2570 to flesh out the message for delivery to the Gateway 
Server 2580. The collection of the VPOS OLE Server 2550, VPOS API DLL 

10 2560 and the Protocol Class DLL 2570 make up the VPOS Software 

Development ToolKit (SDK) which are used to enable VPOS applications for 
interfacing with an Operator 2540. 

VPOS/VGATE Architecture 

15 The architecture of the Virtual Point of Sale (VPOS) and Virtual Gateway 

(VGATE) architecture maintains SET compliance while providing support for 
additional message types that are not enabled in SET. The architecture 
includes isolation of cryptographic details in a single module to facilitate 
single version government approval while maximizing the flexibility of the 

20 system for customization and facilitating transfer of updated versions on an 
acquirer specific basis. Figure 18 is a block diagram of the extended SET 
architecture in accordance with a preferred embodiment. Processing 
commences at function block 1800 for a consumer-originated transaction 
via the World Wide Web (WWW) or 1810 for a merchant-originated 

25 transaction on the internet. In either case control passes immediately to the 
WWW server 1820 for the transaction to be appropriately formatted and the 
appropriate interface page presented, whether the transaction is a store 

front 1822, shopping cartJL824, payipage 1826, standard terminal^ 

administration 1828-1830 transaction, or an extended terminal transaction 
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1834. If processing requires authentication of the transaction, then control 
passes through the Virtual Point of Sale (VPOS) Application Programming 
Interface (API) library 1840 for SET compliant transactions and through the 
VPOS API extensions library for extensions to the SET protocol. Then, at 
5 function block 1842, if the transaction is SET compliant, and function block 
1864 if the transaction is not SET compliant, a library of protocol stack 
information is used to conform the message before it is transmitted to a 
Gateway site for ultimate delivery to a bank host 1874 for authorization. 

10 Extended SET messages are processed at the Gateway site on a two track 
basis with the division criteria being SET compliance (which will change over 
time as more functionality is put into SET) or SET extensions. Set compliant 
messages are processed via the protocol statck library 1862, while SET 
extensions are processed, via the protocol stack en tension library 1864. 

15 Then, at function block 1870 the gateway engine processes SET and Host 
specific code including gateway administration extensions 1872 that bypass 
the normal processing and flow directly from the merchant and consumer 
server 1820 to the gateway administration extensions 1872 to the Gateway 
Engine 1870. 

20 

As described above, there are three channels by which messages are 
exchanged between VPOS 1846 and VGATE 1856. 

1. Standard SET messages 
25 The standard SET messages are originated by the merchant software either 
via a pay page 1826 directly controlled by the consumer, or via an operator 
interface consisting of a set of HTML pages and associated executables 
launched by the pages (e.g. pay page 1826 and standard terminal 
administration 1828-1830.) 
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Each SET message type (e.g., authorization v. capture) transmits a different 
set of data and each requires a different Protocol Data Unit (PDU) to describe 
its encoding. Examples of how Standard SET messages are encoded are 
5 given in the SET documentation previously incorporated by reference. 

2. Extended SET messages 

The Extended SET messages are utilized as an "escape mechanism" to 
implement acquirer-specific messages such as settlement/ reconciliation, 

10 employee logon/logoff, and parameter download. The messages are 

developed as a set of name-value pairs encapsulated in a PKCS-7 wrapper 
and wrapped in Multipurpose Internet Mail Extensions (MIME), described in 
a book by N. Borenstein & N. Freed, "RFC 1521: MIME (Multipurpose 
Internet Mail Extensions) Part One: Mechanisms for Specifying and 

15 Describing the Format of Internet Message Bodies" (Sep. 1993). The name- 
value pairs can have arbitrary (8-bit) data, so arbitrary items can be passed 
through the extended SET channel, including executable programs and 
Dynamic Load Libraries (DLL)s. 

20 Figure 18B illustrates a multipart MIME message with one Extended SET 
message and one Standard SET authorizing message. Mime is utilized as an 
outer wrapper 1890 to allow an Extended SET message 1891 to be 
transmitted as a compon of messages embedded in one MIME multipart 
message. In this manner, a standard SET message can be sent with an 

25 Extended SET message in one VPOS/VGATE communication transaction. 

Embedding the Extended SET messages in a PKCS-7 wrapper enables the 
same message authentication^to occur as in standard SET messages. Thus, 



WO 98/37675 



PCT/US98/03236 



for SET-compliant and non-SET-compliant messages, the same mechanism 
may be 

used to restrict which entities the vPOS or vGATE will trust in any 
communications. .An important concept in Extended SET is that all 

5 messages, of any type, are sent in a uniform name/value pair format, thus 
allowing a single Protocol Data Unit to suffice for any type of message sent 
through the Extended SET channel. Since arbitrary data may be sent this 
way, a mechanism must be provided to preclude the use of the Extended 
SET channel by parties other than approved financial institutions. If this is 

10 not ensured, then the NSA and the US Department of Commerce will not 
approve the software for export. 

SET itself to some degree ensures that this Extended SET channel is used 

only by financial institutions. The 
15 protocol stack extension library only processes messages that have been 

signed by a financial institution SET certificate that is in turn signed by a 

payment instrument brand certificate (such as Visa or MasterCard). 

Stronger control over the Extended SET channel can be achieved by further 

restricting processing of messages to those signed (either instead of or in 
20 addtion to the financial institution SET certificate) by a second 

certificate belonging to a third-party agency, either governmental or private 

(e.g., VeriFone, as manufacturer of the software). 

In this way, a particular set of Extended SET messages can be implemented 
25 by Bank X, and a different set of messages by Bank Y. If a vPOS has an 
extended terminal transaction interface as shown in Figure 18A at block 
1834 for Bank X, and has been configured to only accept messages from a 
vGate with Bank X's certificate, then it will be able to communicate those 
messages to a vGate that has the certificate for Bank X, and accepts 

IV) 
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messages of the types in Bank X's message set. The vPOS will not be able to 
connect to the Bank Y gateway, or to any other system that purports to 
communicate via Extended SET. This restriction is further secured by 
utilizing a public key 
5 certificate that is "hard wired" into vPOS, and which is distributed only to 
gateways that use the Extended SET mechanism and which have been 
approved for export by the US Commerce Department. 

Figure 18C is an example flowchart of message processing in accordance 

10 with a preferred embodiment. Processing commences at function block 
1880 when a message is received by an HTTPS server or other listener and 
passed to decision block 1883 to determine if the sending VPOS has 
transmitted an authentic message and if the VPOS is authorized to 
communicate with this gateway. If the message is not authentic, then the 

15 message is logged as an error and the error is handled as shown in function 
block 1889. If the message is authentic, then the message is decrypted at 
function block 1884 and the PDU parses the message into name / value 
pairs. Then, based on the message type and the extended SET version 
information, the remaining message is parsed at function block 1885 and 

20 the message is checked for conformance to the appropriate specification as 
shown at decision block 1887. If the message does not conform, then it is 
logged and the error handled at function block 1889. If the message 
conforms to the proper specification in decision block 1887 then the 
message is translated into the appropriate host format and sent to the host 

25 as shown in function block 1888. Thus, when a gateway receives an 

incoming message from a vPOS and parses the Extended SET portion of the 
message, a single MIME message can transmit a SET message and/or an 
Extended Set Message. 
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An export license for the encrption can be obtained on a case-by-case basis, 
and since there will be potentially millions of VPOS's, it is desireable to 
obtain a commodities jurisdiction for the vPOS, to enable a single version of 
the VPOS (rather than one version for each bank) to be supported by the 
VPOS architecture. The architecture described here ensures that the single 
version of VPOS, no matter how it is configured with extended terminal 
transaction 

interfaces, cannot be used to communicate any data other than that 
contained in the extended SET messages that have been approved for export 
by the US government to be used exclusively for a specific bank. 

Figure 18D is an example of a simple message between vPOS and vGate 
using the Extended SET channel enabling an employee to sign on, or "logon" 
to a given terminal in accordance with the subject invention. The message 
must contain the employee's logon ID, a password to be verified by the bank 
host computer, and the date and time as shown at 1894. 

While the contents of the message are shown without encryption in Figure 
18D, it should be noted that the information (including the logon password) 
are SET encrypted inside the PKCS-7 wrapper 1894. Certain fields may be 
designated as mandatory for an Extended SET message, to allow the vGate 
or vPOS to decide how to handle the message. For the sake of clarity, in this 
message 1894, only two fields, "messagetype" and "ESETversion", are 
mandatory. These fields inform the vGate that this message is of type 
"logon," and that the vPOS is using version "1.0A" of the ESET message 
formats defined for the vGate. In this embodiment, the length indicator "(5]" 
is used to distinguish the length (in bytes) of the field of type "messagetype" 
in the message. In this way^ere are^no special end-of-data characters, ^ 
and therefore arbitrary data need not have any "escaped" characters. 
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It should be noted that using escaped characters will work equally well. 
Total message integrity is assured by the digital signatures in the PKCS-7 
wrapper. This does not, however, preclude the use of other checksumming 
schemes for additional pinpointing of transmission or encoding errors. The 
messagetype and ESETversion name/value pairs facilitate vGate look up of 
what name/value pairs are expected in the "logon" message. Some 
name/value pairs may be mandatory, and others may be optional. 

Figure 18E is an example of a simple message between vPOS and vGate 
using the Extended SET channel enabling an employee to sign on, or "logon" 
to a given terminal in accordance with the subject invention. In response to 
the logon request message from a vPOS, the vGate may respond with a 
"logon accepted" message 1894, as depicted in Figure 18E, which vPOS, 
upon receipt and authentication, then uses to unlock the terminal for that 
user. 

3. Gatewav-intitiated messages 

Since all SET messages between a merchant and an acquirer are currently 
merchant-initiated, there must be a separate mechanism for initiating a 
message from a gateway, for example to request the upload of MIB data, or 
to download new parameters. This is accomplished by requiring the gateway 
to send a message to the merchant via a MIME-encapsulated PKCS-7 
message containing name-value pairs to the merchant server directly, rather 
than to the SET module. This channel is shown in Figure 18A at block 
1860. 

.JChejme.sjs.age is verified for origination from the acquirer, and is utilized to 
either initialize a merchant action, such as to update the merchant's 
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administration page (for example by blinking a message saying, "PLEASE 
RE-INITIALIZE YOUR TERMINAL"), or by initiating a request/response 
message pair originating from the merchant (for example, "HERE ARE THE 
CONTENTS OF MY MIB") . This is achieved by calling one of the extended 
terminal transaction interfaces (Figure 18A at 1834), which in turn 
indicates a SET transaction. 

Gateway Customization via the Ex tended SET Channel 

Gateway customization in extended SET is extremely powerful and a novel 
concept for VPOS processing. Each VPOS contains a "serial number 8 which 
is unique to each copy of the software. Once a merchant has selected an 
acquirer and obtained the appropriate certificates, the VPOS can be 
customized utilizing the communication link and messages containing 
customization applications. 

Let us consider an example in which a Wells Fargo Bank (WFB) distributes 
VPOS via different sales channels. The first is direct from WFB to an 
existing merchant with whom WFB already has an existing relationship. In 
this case, a version of VPOS customized for WFB is sent to the merchant. 
The customizations may involve modification or replacement of, for example, 
a store front 1822, shopping cart 1824, pay page 1826, standard terminal 
administration transaction interface 1828-1830 or an extended terminal 
transaction interface 1834. 

Using the built-in "serial number" certificate and the Test Gateway public 
key, it is possible to securely download customization applications to a 
specific VPOS application. Once the VPOS is appropriately configured, the 
last stage of customization download is to configure the VPOS so that it only 
responds to a public key certificate of the merchant's acquirer. 
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Thread Safe VPOS - TID Allocation 

Physical terminals process a single transaction at a time since clerks are 
usually only able to process one transaction at a time. Web Servers can 

5 process many transactions at a time, so payment requests can often occur 
simultaneously. Thus, the VPOS Software must have support for multi- 
tasking and provide support for multiple threads to be active at the same 
time in the same system as well as the same process. This requirement is 
relatively straight forward. However, the authorizing banks require that all 

10 transaction requests include a Terminal ID (TID), and, for many banks, no 
single TID may be active in any two transaction requests that overlap in 
time. Thus, the VPOS requires dynamic allocation of TIDs to requesting 
threads. 

15 To provide for this requirement, the VPOS provides a TID pool in tabular 

form in a database management system (DBMS). This table has two colums: 
TID NAME & Allocation date/time. If the TID date is null, then the TID is 
not in use and may be assigned. A date/time field is utilized to allow TID 
allocations to expire. TID requests are made utilizing a SQL query on the 

20 TID Pool to find the first null or expired date/ time, which is replaced with 
the current date/ time and the TID name returned. 

REMOTE VPOS 

The unique archtitecture of the Cardholder 120, Merchant 130 and Gateway 
25 140, as shown in Figure IB, provides communication capability between the 

modules utilizing the internet to support linkages 150 and 170. Since the 

internet is so pervasive, and access is available from virtually any computer, 
utilizing the internet as the communication backb one for connecting the 

cardholder, merchant and access to the authorizing bank through a gateway 
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allows the merchant VPOS software to be remotely located from the 
merchant's premises. For example, the cardholder could pay for goods from 
any computer system attached to the Internet at any location in the world. 
Similarly, the merchant VPOS system could be located at a central host site 
where merchant VPOS systems for various merchants all resided on a single 
host with their separate access points to the Internet. The merchant could 
utilize any other computer attached to the Internet utilizing a SSL or SET 
protocol to query the remote VPOS system and obtain capture information, 
payment administration information, inventory control information, audit 
information and process customer satisfaction information. Thus, without 
having to incur the overhead of maintaining sufficient computer processing 
power to support the VPOS software, a merchant can obtain the information 
necessary to run a business smoothly and avoid hiring IS personnel to 
maintain the VPOS system. 

VPOS Multi-Merchant Processing 

Multiple merchant processing refers to the ability of a plurality of merchants 
to process their individual VPOS transactions securely on a single computer. 
The architecture relies on each payment page obtaining the merchant name 
in a hidden field on the payment page. The VPOS engine receives the 
merchant name with a particular transaction and synchronizes the 
processing utilizing a Set Merchant method. This command causes the 
VPOS API to look up a unique registry tree based on the merchant name. 
This process causes the VPOS engine to engage the appropriate 
configuration to process the transaction at hand utilizing a Microsoft 
Registry Tree. A registry tree contains Card Definition Tables (CDT)s, 
Acquirer Definition Tables (ADT)s, Merchant Definition Tables (MDT)s, 
ProtocoLConfiguration Tables (PCT)s, etc. The CDTs point to specificADTs 
since each supported card can be supplied by a distinct acquirer. This is 
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one form of split connection. Each of the ADTs in turn point to PCTs, and 
some acquirers can support multiple parallel gateways. A merchant's name 
refers to a unique database in the database management system which 
contains for example, TIDs. 

5 

So, for example, to fully qualify a particular merchant in a multi-merchant 
system, the Acquirer Definition Table is queried to ascertain the particular 
Gateway (VFITest), then if Bank of America requires verification of network 
communication information, the particular CardDT is accessed with for 
10 example VISA. The particular merchant will service VISA transactions 

utilizing a particular acquirer. The particular piece of merchandise will also 
be detailed in a data base. Finally, the merchant Configurations wil 1 also 
be stored in the database to facilitate E-mail and name lookup. 

15 VPOS CLIENT 

The interaction between the VPOS and a client commences when a pay page 
solicits parameters of a transaction. Then, the parameters are validated to 
be sure the payment instrument, for example, cardnumber is not null. 
Then, a transaction object is created, eg. AUTHONLY, and the object is 
20 initialized and stuffed with parameters of the transaction, eg. 

ao.setpan(accnum), and the object is executed. This execution invokes the 
VPOS engine. The VPOS engine further validates the parameters based on 
the particular merchant's configuration. For example, some merchans do 
not accept American Express Cards, but will take Visa, and all merchants 

25 check the expiration date of the card. Assuming a valid and acceptable 
card has been tendered, then a TID is assigned (expiring, existing TIDs) or 
block a new TID from the TID Pool. This generates a STAN, XID, RRPID 

unique Jag.and creates an initial record in the transaction d ataba se which is 

flagged as before gateway processing in case the transaction crashes and 
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must be backed out. Then the protocol parameters are identified in the 
registry based on card type, and a particular acquirer identified. Then, a 
protocol object is created and executed to extract results from the protocol 
object and the before gateway "bit" is flipped to again flag the location of the 
5 transaction in the process as it is submitted to the Gateway. 

The results received back from the Gateway are placed into a transaction 
object with is reported back to the pay page and ultimatey back to the pay 
page user. 

10 

VPOS Merchant Pay Customization 

A novel feature of the VPOS software provides payment page customization 
based on a merchant's preferences. This feature automatically lists cards 
that are accepted by a particular merchant based on the active terminal 
15 configuration. Each approved card for a particular merchant is linked to the 
display via an URL that provides a pointer to the credit card information 
supported by the merchant. Each card has an entry in a data structure 
referred to as the Credit Definition Table (CDT). 

20 A preferred embodiment of the VPOS merchant pay customization software 
in accordance with a preferred embodiment is provided in Figure 19 which 
illustrates the logic utilizing a flowchart, and a listing of the source code 
below. Processing commences at terminal 1900 and immediately flows to 
function block 1910 where an index variable is initialized for stepping 

25 through each of the accepted payment instruments for the merchant's page. 
Then, at function block 1930, a URL key is obtained associated with the 
current merchant pay page and index value. The URL key is a registry key 
name that points to a picture of a credit card that the merchant has 
associated with the pay page and which the merchant accepts as payment. 
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At output block 1940 the card image associated with the URL key is 
obtained and displayed on the terminal. The CDT entry is obtained at 
function block 1950 utilizing the URL key. The CDT is utilized for storing 
information associated with each card. Then, at decision block 1960, a test 

5 is performed to determine if the last payment method card has been 

processed and displayed on the merchant display. If not, then the index is 
incremented at function block 1920 and the loop reiterated to process the 
next card at function block 1930. If all the cards have been processed, then 
control is returned to the merchant program for processing the transaction 

10 at terminal 1970. 

Figure 20A-20H are block diagrams and flowcharts setting forth the detailed 
logic of thread processing in accordance with a preferred embodiment. 
Figure 20A illustrates a prior art approach to POS processing utilized in 

15 most grocery stores and department stores today. Figure 20B is a data 
structure of a POS transaction request in accordance with a preferred 
embodiment. Figure 20C illustrates VPOS architecture with account 
requests being processed by a single acquiring bank. Figure 20D illustrates 
a VPOS Transaction request data structure in accordance with a preferred 

20 embodiment. The transaction type, VPOS Terminal ID, Amount, Currency 
type, Digital Signature, Account number, Expiration date and other 
information are all stored in this record for later retrieval. Figure 20B is a 
blow up of a portion of a TID allocation database in accordance with a 
preferred embodiment. Figure 20F-H are flowcharts of the detailed logic in 

25 accordance with a preferred embodiment. 

#include "rr.h" 

#ifndef_NT__ 

#define_NT 
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extern void _setenvp(); 
#endif 

iiniiiiiiiiiniiiiiiiiiiii//iiiiiiiiiifiii/i/iiiii/iiiii/iti/ 

I 

1 1 AcquireBillHtml 

//On Pay page, output form entries to acquire billing information 

iniiiuiuiniiiiiiiniiiiiiiiniinuiiiiminmiiiiiiini 
i 

EStatus AcquireBillHtml(CWSINT& clWSINT, int nTot, CProf& clProfile, 
EPCLCurrency eCurrency) { 
/ / Current time 

time_t tNow; / /figure out current year for Credit card expiry 

struct tm *tmNow; 

char szYear[DB_YEAR_SZ +1]; 

char szAmount[FORMATTED_CURRENCY + 1]; 

time(&tNow); 

tmNow = localtime(&tNow); 

strftime(&szYear[0], (size_t)DB_YEAR_SZ + 1, "%Y", tmNow); //needs 

extra 1 for null 

int nYear = atoi(szYear); 
/*<TH>Payment Type</TH>\n<TD><INPlIT SIZE = 20 NAME=b_instrument 

VALUE=\"" \ 

« clProfile.m_b_instrument « "\"></TD>" \ 

« "*/ 

clWSINT « " < CENTERxTABLE BORDER=0><CAPTION ALIGN = 

TOP><B^BillTo</B></CAPTipN>\n M ; 

clWSINT « "<TR ALIGN=LEFT> <TH> Account Number</TH><TD 
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COLSPAN = 5><INPUT SIZE = 56 MAXLENGTH = " 

« ACCT_NUM_SZ « " NAME=b_card> </TD></TR>\n"; 
clWSINT « "<TR ALIGN=LEFT><TH>Name on Card</TH><TD><INPUT 
SIZE= 20 MAXLENGTH= " « NAME_SZ 
5 « " NAME=b_name VALUE=\"" « clProfile.m_b_name 

« "\"> </TD><TH>Expiration</TH><TD>Month < SELECT 
NAME = b_expire_month><OPTION> 01\n <OPTION> 02\n" « 

"<OPTION> 03\n <OPTION> 04\n<OPTION> 05\n<OPTION> 
06\n<OPTION> 07\n<OPTION> 08\n<OPTION> 09\n" « 
10 "<OPTION> 10\n<OPTION> ll\n<OPTION> 12\n</SELECT> 

Year < SELECT NAME = b_expire_^ear><OPTION>" « nYear « 

"<OPTION>" « nYear + 1 « "<OPTION>" « nYear + 2 « 
"<OPTION>" « nYear + 3 « "<OPTION>" « nYear + 4 « 
" < / SELECTx /TD>< /TR> \n"; 
15 //<TH>Expires</THxTD>Month<INPUTSIZE=3 
NAME=b_expire_month> Year <INPUT SIZE=5 
N AME=b_expire_y ear > < / TD>< /TR> \n"; 

clWSINT « "<TR ALIGN=LEFT><TH>Address Line 1</TH><TD 
COLSPAN=5><INPUT SIZE=56 MAXLENGTH= " « ADDR_SZ 
20 « " NAME=b_addrl VALUE=\"" « clProfile.m_b_addrl « "\"> 

</TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT><TH>Address Line 2</TH><TD 
COLSPAN=5><INPUT SIZE=56 MAXLENGTH = " « ADDR_SZ 

« " NAME=b_addr2 VALUE=\"" « clProfile.m_b_addr2 « "\"> 

25 </TD></TR>\n"; 

clWSINT « "<TR ALIGN =LEFT> <TH > City< /TH > <TD > < INPUT 
MAXLENGTH= " « CITY.SZ « " NAME=b_city VALUE=\"" 

« clProfile.m_b_city.<<J , .\^_</TP> ,, « 

"<TH>State/Province</TH><TD><INPUT MAXLENGTH = " « STATE_SZ 
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« " NAME=b_state VALUE=\"" « clProfile.m_b_state « "\"> 

</TD></TR>\n"; 

clWSINT « " <TR ALIGN=LEFT><TH> Country < / TH > <TD > < INPUT 

MAXLENGTH= " « COUNTRY_SZ 

« " NAME=b_country VALUE=\" M « clProfile.m_b_country << 
"\"> </TD><TH>Zip/Postal Code</TH><TD><INPUT MAXLENGTH= " 

« ZIP_SZ « " NAME=b_zip VALUE=\"" « clProfile.m_b_zip « 
"\"></TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT> <TH > Email< /TH><TD>< INPUT 
MAXLENGTH= " « BEMAIL_SZ « " NAME=b_email VALUE=\"" 

« clProfile.m_b_email « "\"></TD>" « 
"<TH>Phone</TH><TD><INPUT MAXLENGTH= " « BPHONE_NUM_SZ 

« " NAME=b_phone VALUE=\"" « clProfile.m_b_phone « 

"\"> </TD></TR>\n"; 

clWSINT « "</TABLE></CENTER><P>\n"; 

/ /NPW « " NAME=b_addrl> </TD>" « "<TH>Payment 
Instrument /TH>\n<TDxSELECT NAME =b_instrument>"; 

/ /hack from ini (bug) which pay instruments supported 

/ /NPW clWSINT « "<OPTION> Credit Card\n" « "<OPTION> Debit 
Card\n</SELECT></TDx/TR>\n"; 

CurrFormat(nTot, eCurrency, szAmount); 

clWSINT « " < CENTER> < FO NT SIZE=5>Total = " « szAmount « 
" < / FONT> < / CENTER> " ; 
return (eSuccess); 

} 

iiiiiiiiiiinujuijuuiiwujmuiiiiiiiiiiiiiiiiiujuuLL 
i 
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//PayButtonsHtml 

/ / Output buttons on pay page: return to shop, pay, pay window, 
/ / modify order 

////////////////////////////////////////////////////////////// 

5 / 

void PayButtonsHtml(CWSINT& clWSINT, char* pszShopUrl, CRRReg& 
clReg) { 

char *pszHomeUrl = clWSINT.LookUp("home_urr'); 
10 char *pszModifyUrl = clWSINT.LookUp("modify_url"); 

char *pszSoftUrl = clWSINT.LookUp("soft_url") ; 

if (IpszHomeUrl) pszHomeUrl = pszShopUrl; //Home Page 
//if (IpszModifyUrl) pszModifyUrl = pszShopUrl; //Shopping Cart 
15 typically 

clWSINT « "<CENTER><H4>By pressing the Pay! button I agree to 
pay the above total amount<br> according to the card issuer 
agreement<H4></CENTER>\n"; 
20 clWSINT « "<CENTER> \n< A HREF = " « pszShopUrl « "> <IMG 

SRC=" « clReg.m_szReturnShop « " BORDER = 0></A>\n"; 
#ifdef_SC 

clWSINT « "<INPUT TYPE = IMAGE NAME = gso SRC = " « 
clReg.m_szModifyOrder « " BORDER = 0>\n"; 
25 #else 

if (pszModifyUrl) 

clWSINT « "<A HREF = " « pszModifyUrl « "> <IMG SRC=" « 

clReg.nv szModifyOrder « " BORDER = 0><_/h>\rf; 

#endif 
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clWSINT « "<INPUT TYPE = HIDDEN NAME = home_url VALUE = " « 
pszHomeUrl « ">\n" 

« "<INPUTTYPE = IMAGE NAME = vpos SRC = " « clReg.m_szPay « 

" BORDER = 0>\n- 
5 « "<INPUT TYPE = HIDDEN NAME = shop^url VALUE = " « 

pszShopUrl « ">\n" 

« "<INPUT TYPE = HIDDEN NAME = store VALUE = " « 
clWSINT.LookUp("store") « ">\n"; //Can't be NULL or error previously 

if (pszSoftUrl) 

10 clWSINT « "<INPUT TYPE = HIDDEN NAME = soft_url VALUE = 

" « pszSoftUrl « ">\n"; 

clWSINT « "</CENTER>\n"; 

} 

iiiiiiiiiiiiiiiiiiiiiiiuiiiiiiiiiiiiiiiiiiiiinniiiiiiiiiiii 

15 / 

// DisplayPayPage 

// Outputs billing form, buttons, and static gso 

////////////////////////////////////////////////////////////// 
/ 

20 EStatus DisplayPayPage(CWSINT& clWSINT, CRRReg& clReg, int nError) { 
EStatus eStat; 

char szFileLine[BUFFER_SZ + 1]; 

char *pszTag, *pszRefererUrl, *pszShopUrl, *pszExePath, 
25 *pszServerName; 

time_t tNow; 
int nTagExist = FALSE; 
_ „HKEY hCardsKey; //To enumerate cards 
long retCode; 
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int nNoCards; 
DWORD dwtype, dwlen; 
HKEY hCardKey; 

char szCardBuf|MAX_PATH + 1], szCardPic[MAX_PATH + 1]; 

5 

#ifdef_SC 

CPOLBk clBkGso; 

#else 

char *pszTxn, *pszGsoNum, *pszGsoOpaque, *pszTot; 
10 #endif 

/ /Shipping headers. If come from gso page and cookies are not set, 

set. 

CProf *pProfile; 
15 pProfile = new CProff); 

if (IpProfile) return (eRRNewFailed); 

eStat = pProfile->Init(clWSINT); 

if (eStat != eSuccess) return (eStat); //Init failed 

20 #ifdef _SC /*No session cookie for the pay page. This means the user will 
either use a long 

term cookie or type in their info each time*/ 
clWSINT « "Set-Cookie: profile=" « pProfile->GetCookieLine() « "; 
path=/\n"; 

25 /* if (clWSINT.LookUp("Server Name")) 

clWSINT « "; domain = " « clWSINT.LookUp("Server Name") « 

";\n";*/ 

#endif . 
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#ifdef„SC 

//Shipping filled in? 

if (!(pProfile->m_s_name[0] 8&8& pProfile->m_s_addrl[0] 8g8& pProfile- 
>m_s_city[0] &8& pProfile->m_s_state[0] 8&8& 

pProfile->m_s_zip(0] 8&8& pProfile->m_s_country[OJ 8585 pProfile- 

>m_s_ship[0])) { 

eStat = DisplayGsoPage(clWSINT, clReg, ERROR_DISPLAY); 

/ / bug, return correct? 

return eStat; 

} 

/ /Creates shopping basket from CGI/ Cookies 

eStat = clBkGso.Init(clWSINT, *pProfile, clReg); 

if (eStat != eSuccess) return (eStat); //eRRBasketCreateError 

/ /Cookies then other headers 
clBkGso.ToCookies(clWSINT, REGULAR); 
#endif 

/ /clWSINT « "Pragma: no-cache\n"; 
clWSINT « "Content-type: text/html\n\n"; 

/ /Where to position the page, if all information is filled in, here, 
if (InError) {clWSINT « "<A NAME=jump></A>";} 

//Output HTML 
if stream ifPay; 

ifPay.open(clReg.m_szPayTemplate, ios::in | ibs::nocreate); 
if (ifPay.failO) return (eRRCantOpenPayTempJate);_/_/coul_dn'txead pay 
template file 
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//HTML Template 
while (ifPay) { 

ifPay.getline(szFileLine, BUFFER_SZ); 

if (HpszTag = strstr(szFileLine, DYNAMIC_TAG))) 
clWSINT « szFileLine « "\n"; 

else { 

nTagExist = TRUE; 

//Null the tag, Output the beginning of the line, 
//make the dynamic basket call, output the rest of the 

line 

if (strlen(szFileLine) == strlen(DYNAMIC_TAG)) 
pszTag[0] = NULL; 

else { 

pszTag[0] = (char) NULL; 

pszTag += strlen(DYNAMIC_TAG) + 1; //was 9 

} 

clWSINT « szFileLine; 
//Dynamic call 

pszRefererUrl = clWSINT. LookUp("Referer"); 
if (IpszRefererUrl) return (eRRNoRefererUrl); 
pszExePath = clWSINT.LookUp("Execu table Path"); 
if (IpszExePath) return (eRRNoExePath); 
pszServerName = clWSINT.LookUp("Server Name"); 
if (IpszServerName) return (eRRNoServerName); 
clWSINT « "<FORM METHOD = POST ACTION = http"; 
if (clReg.m_nUseSSL) 

. clWSINT « "s"; 

clWSINT « ":/ /" « pszServerName « pszExePath « 
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"#jump>"; 

/*clWSINT « "<FORM METHOD = POST ACTION = " « 
pszExePath « "#}ump>";*/ 

5 

/ / Setting Long Cookies 

clWSINT « "<CENTER>If you wish to have billing and 
shipping defaults set in your browser, check this box " 

« "<INPUT TYPE = CHECKBOX 
1 0 NAME=long_cookies>< / CENTER> \n" ; 

/ /Fill it in message 
if (nError) { 

clWSINT « "<A NAME=jump>< / A>"; 
clWSINT « "<CENTER><H4>You must fill in 
15 <I>all< /I> of the billing information except for <I>address line 2</I> and 
<I>email</I>.</H4></CENTER>"; 
} 

/ /GsoNum 

#ifdef_SC 

20 time(&tNow); //For multithreading, append instantiation 

number 

clWSINT « "<TABLE ALIGN=RIGHT> <TR> <TH > Order 
Number</TH><TD>" « tNow 

« "</TDx/TR></TABLE><BR 
25 CLEAR=ALL> \n<INPUT TYPE=HIDDEN NAME=b_gso_num VALUE = " « 
tNow « ">\n": 
#else 

/./Pay page_API: transaction type, GSO #, gso opaque 

pszGsoNum = clWSINT. LookUp("b_gso_num"); 
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if (pszGsoNum) 

clWSINT « "<TABLE 
ALIGN=RIGHT> <TR><TH > Order Number</TH><TD>" « pszGsoNum 

« "</TD></TR></TABLExBR 
5 CLEAR=ALL> \n<INPUT TYPE=HIDDEN NAME=b_gso_num VALUE = " « 
pszGsoNum « ">\n"; 

else { 

time(&tNow); //For multithreading, append 

instantiation number 
10 clWSINT « "<TABLE 

ALIGN=RIGHT><TR><TH>Order Number</TH><TD>" « tNow 

« "</TD></TRx/TABLExBR 
CLEAR=ALL>\n<INPUT TYPE=HIDDEN NAME=b_gso_num VALUE = " « 
tNow « ">\n"; 
15 } 

//Some pay page only specifics: transaction to execute, 

gso opaque 

pszTxn = clWSINT.LookUp("transaction"); 
if (pszTxn) 

20 clWSINT « "<INPUT TYPE=HIDDEN 

NAME=transaction VALUE = " « pszTxn « ">\n"; 

pszGsoOpaque = clWSINT.LookUp("gso_opaque"); 

if (pszGsoOpaque) 
25 clWSINT « "<INPUT TYPE=HIDDEN 

NAME=gso_opaque VALUE - \ M " << pszGsoOpaque « , '\">\n"; 
#endif 



#ifdef_SC 

1% 
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//Bill to information & Payment Instrument 
eStat = AcquireBillHtml(clWSINT, clBkGso.GetTot(), 

*pProfile, (EPCLCurrency) clReg.m_eDefaultCurrency); 

#else 

//Pay Page alone requires a total 

pszTot = clWSINT.LookUp("total"); 

if (IpszTot) return (eRRNoPayTotal); 

eStat = AcquireBillHtml(clWSINT, atoi(pszTot), *pProfile, 
(EPCLCurrency) clReg.m_eDefaultCurrency) ; 

clWSINT « "<INPUT TYPE=HIDDEN NAME=tOtal VALUE 
" « pszTot « ">\n"; 
#endif 

if (eStat != eSuccess) return (eStat); //error from db? 
within AcquireBillHtml 

clWSINT « "<P>\n"; 

//Output Buttons on Form 

pszShopUrl = clWSINT.LookUp("shop_url"); 
if (! pszShopUrl) 

PayButtonsHtml(clWSINT, pszRefererUrl, clReg); 

else 

PayButtonsHtml(clWSINT, pszShopUrl, clReg); 
/ /Registry Card LookUp 

clWSINT « " < CENTER> <TABLE CELLSPACING = 
5><TRxTH> Cards Accepted:</TH>"; 

RegOpenKeyEx(clReg.m_hStoreKey,; , APIV\CDT^0 __. 

KEY_READ, fchCardsKey); 
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dwlen = sizeof(int); 

RegQueryValueEx(hCardsKey, "NoOfRows", 0, 86dwtype, 
(LPBYTE)86nNoCards, &dwlen); 

-for (int i = 0; i < nNoCards; i++) { 

RegEnumKey(hCardsKey, i, szCardBuf, MAXJPATH 

RegOpenKeyEx(hCardsKey, szCardBuf, 0, 
KEY_READ, &hCardKey);' 

dwlen = MAX_PATH + 1; 

retCode = RegQueryValueEx(hCardKey, 
"CardPicture", 0, &dwtype, (LPBYTE) szCardPic, &dwlen); 

if (retCode != ERROR_SUCCESS) return 

eRRRegistryFailure; 

clWSINT « "<TD><IMG SRC = " « szCardPie « 

"></TD>"; . . 

RegCloseKey(hCardKey); 

} 

RegCloseKey (hCardsKey) ; 

clWSINT « "</TR>< /TABLEx / CENTER> " ; 

clWSINT « "</FORM>\n<HR>\n"; 

#ifdef_SC 

//Output static HTML Table 
clBkGso.ToHtml(clWSINT, NOEDIT); 
//Output static Shipping information 
StaticShipHtml(clWSINT, *pProfile); //Also NO_EDIT 
clWSINT « "<HR>\n"; 

#else . 

/ /Pay page alone takes and passes through a gso 
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if (pszGsoOpaque) 

clWSINT << pszGsoOpaque « "\n"; 

#endif 

-/ /Rest of Line from template file 
if(pszTag) clWSINT « pszTag; 

} 

} 

if (nTagExist != TRUE) 

return (eRRNoDynamicTag) ; 

else 

return (eSuccess); 

} 

//////////////////////////////// 
//Receipt Page 

////////////////////////////////////////////////////////////// 
//////////////////////////////// #ifdef - sc 

////////////////////////////////////////////////////////////// 

I ■ 

II StaticShipHtml 

//On Pay page, output Static table of shipping information 
/ / based on cookies set in prior page 

////////////////////////////////////////////////////////////// 
/ 

void StaticShipHtml(CWSINT& clWSINT, CProf clProfile) { 

clWSINT « " < CENTER> <TABLE CELLSPACING=10>< CAPTION ALIGN 
= TOP><B>Ship To<B></CAPTION>\n"; 

- clWSINT-« "<TR>_<TH ALIGN=LEFT>Name</TH><TD>" << 

clProfile.m_s_name « "</TD>" « 

IH1 
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"<TH ALIGN=LEFT>Address Line 1</TH><TD>" « 
clProfile.m_s_addrl « "</TD></TR>\n"; 

clWSINT « "<TR><TH ALIGN=LEFT> Address Line 2</TH><TD>" « 
clProfile.m_s_addF2 « "</TD>" « 
5 "<TH ALIGN=LEFT>City</TH><TD>" « clProfile.m_s_ci1y « 

"</TD></TR>\n"; 

clWSINT « "<TR><TH ALIGN=LEFT> State/ Province< /TH><TD>" « 

clProfile.m_s_state « "</TD>" « 

"<TH ALIGN=LEFT>Zip/ Postal Code</TH><TD>" « 
10 clProfile.m_s_zip « ,, </TD></TR>\n"; 

clWSINT « "<TR><TH ALIGN=LEFT> Country< /TH ><TD >" « 
clProfile.m_s_country << "</TD>" « 

"<TH ALIGN=LEFT>Shipping Method</TH><TD>" « 
clProfile.m_s_ship « "</TD></TR>\n M ; 
15 clWSINT « "</TABLE></CENTERxP>"; 

} 

#endif 

20 ////////////////////////////////////////////////////////////// 
/ 

// StaticBillHtml 

//On Receipt page, output static table of billing information 

////////////////////////////////////////////////////////////// 
25 / 

void StaticBillHtml(CWSINT& clWSINT, CProf clProfile) { 

/ *<TH>Payment Type<7TH>.\n<TD>"_<< clProfile.m_b_instrument_ 
« "</TD>*/ 

(«ro 
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clWSINT « " < CENTER> <TABLE CELLSPACING=10><CAPTION ALIGN 
= TOP><B>Bill To<B></CAPTION>\n' , ; . 

clWSINT « "<TR ALIGN=LEFT><TH>Account Number</TH><TD 
COLSPAN=3>" « -clProfile.ra_b_card « "</TD></TR>\n"; 
5 clWSINT « "<TR ALIGN=LEFT><TH> Name on Card</TH><TD>" « 

clProfile.m_b_name « 

"</TD><TD><B>Expires:</B><I>Month</I> " « 
clProfile.m_b_expire_month « " <I>Year</I> " « clProfile.m_b_expire_year 
« "</TD></TR>\n"; 
10 clWSINT « "<TR ALIGN=LEFT><TH>Address Line 1</TH><TD 

COLSPAN=3>" « clProfile.m_b_addrl « "</TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT><TH>Address Line 2</TH><TD 
COLSPAN=3>" « clProfile.m_b_addr2 « "</TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT><TH>City</TH><TD>" « 
15 clProfile.m_b_city « "</TD>" 

« "<TH>State/Province</TH><TD>" « clProfile.m_b_state « 
"</TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT><TH>Country</TH><TD>" « 
clProfile.m_b_country « 
20 "</TD><TH>Zip/Postal Code</TH><TD>" « clProfile.m_b_zip 

« "</TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT><TH>Email</TH><TD>" « 
clProfile.m_b_email « "</TD>" 

« "<TH>Phone</TH><TD>" « clProfile.m_b_phone « 
25 "</TD></TR>\n"; 

clWSINT « "</TABLEx/CENTERxP>\n"; 

> 

////////////////////////////////////////////////////////////// 
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/ 

/ /VposReceipt 

/ /Generates a receipt from the return block and profile info. 

iniiiiniiiiHiiiiiiiiiiiuiiiinniiiiiiniiiiiiiiniiiiiiii 
5 / 

#ifdefVPOS_OLE 
#ifdef_SC 

void VposReceipt(CWSINT& clWSINT, /* CVPCLFinCCTrans */ 
CVPCL_01eCCAuthOnly *pTxn, CProf& clProfile, CRRReg& clReg, CPOLBk& 
10 clBkGso) { 
#else 

void VposReceipt(CWSINT& clWSINT, /* CVPCLFinCCTrans */ 
CVPCL_01eCCAuthOnly *pTxn, CProf& clProfile, CRRReg& clReg) { 
#endif 

15 #else 

#ifdef_SC 

void VposReceipt(CWSINT& clWSINT, CVPCLFinCCTrans *pTxn, 
CProf& clProfile, CRRRegfe clReg, CPOLBk& clBkGso) { 
#else 

20 void VposReceipt(CWSINT& clWSINT, CVPCLFinCCTrans *pTxn, 

CProf& clProfile, CRRReg& clReg) { 

tfendif 
#endif 

//Set Long cookies (if applicable) 
25 struct tm *tmNow; 

char szDate[32]; //what is the max date? in this format/ bug 
time_t tNow; 

.time(&tN.ow); 

tNow += clReg.m_nProfileLife * 86400;/ /ini constant for length of 
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cookie stay 

tmNow = localtime(&tNow); 

strftime(szDate, (size_t)31, "%a, %d-%b-%y %H:%M:%S GMT", 
tmNow); 

if (clWSINT.LookUp("long_cookies")) 

clWSINT « "Set- Cookie: cust_profile=" « 
clProfile.GetCookieLine() « "; expires=" 

« szDate « "; path=/\n"; //Profile cookies 

#ifdef _SC / /Shopping cart sets local cookies on receipt 

clWSINT « "Set-Cookie: profile-' « clProfile.GetCookieLine() 

"; expire s=" 

« szDate « "; path=/\n"; //Profile cookies 

#endif 

/*clWSINT << "; domain = " « clWSINT. Lookup ("Server Name") « 
";\n";V 

#ifdef_SC 

/ /Delete shopping basket 
clBkGso.ToCookies(clWSINT, EXPIRE); 

#endif 

clWSINT « "Pragma: no-cache\n"; . 

clWSINT « "Content-type: text/html\n\n"; 

clWSINT « "<HTML><BODY " « clReg.m_szBackgroundString « 

">\n"; 

clWSINT « "<A NAME=jump>< / A> \n"; 

_clWSINT « " < CENTER> < IM G SRC=" « clReg.m_szReceiptBanner < 
"></CENTER>\n"; 



IP 



WO 98/37675 



PCT/US98/03236 



clWSINT « "<CENTER><H2>This is your receipt. Please save it using 
the <I>Save As</I> option from the <I>File Menu</I> in your 
browser</H2></CENTER>"; 

5 / /Vpos Return Block 

char szGso[PURCH_ORDER_NUM_SZ + 1]; 
char szTransAmt[AMT_SZ + 1]; 

char szDisplayTransAmt[FORMATTED_CURRENCY + 1]; //Extra point 
for decimal 

10 enum EPCLCurrency eCurr;// - (EPCLCurrency) 

clReg.m_eDefaultCurrency; 

enum EPCLDecimals eDec;// = eTwoDecDigits; 

char szTime[TRANS_TIME_SZ + 1J; 

char szPan[ACCT_NUM_SZ + 1] ; 
15 char szExpDate[EXP_DATE_SZ +1]; 

char szRetRefNum[RET_REF_NUM_SZ +1]; 

pTxn->GetRespTransAmt(szTransAmt, AMT_SZ + 1, &eCurr, &eDec); 
P Txn->GetPurchOrderNum(szGso, PURCH_ORDER_NUM_SZ +1); 
pTxn->GetRespTransDate(szDate, TRANS_DATE_SZ + 1); 
20 pTxn->GetRespTransTime(szTime, TRANS_TIME_SZ +1); 

P Txn->GetRetRefNum(szRetRefNum, RET_REF_NUM_SZ +1); 
pTxn->GetPAN(szPan, ACCT_NUM_SZ +1); 
pTxn->GetExpDate(szExpDate, EXP_DATE_SZ+1); 

25 clWSINT «"<CENTER><TABLE BORDER=0 

CELLSPACING=10><CAPTION><B>" « clReg.m_szShopName 
« " - Order Number</B> - " « szGso 
« "</nAPTIQN>\n<TR ALIGN=LEFT><TH>Time</THxTD>" << 

szTime[0] 
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« szTime[l] « ":" « szTime[2] « szTime[3] « ":" « 
&szTime[4) « ,, </TD><TH>Date</TH><TD>" 

« szDateJO] « szDatell] « "/" « szDate[2] « szDate[3] « "/" 
« &szDate[4] « -"</TD></TR>" 
5 « "<TR ALI GN=LEFT> <TH > Account Number< /TH ><TD 

COLSPAN=3><B>" « szPan « "</B></TD></TD>" 

« "<TR ALIGN=LEFT><TH>Authorization Code</TH><TD>" « 

"No Auth?" 

« "</TD><TH>Reference Number</TH><TD>" « szRetRefNum 

10 «"</TD></TR>" 

« "</TABLE></CENTER>"; 
CurrFormat(atoi(szTransAmt), eCurr, szDisplayTransAmt); 
clWSINT « "<CENTER><FONT SIZE=5>Total = " « 
szDisplayTransAmt « ,, </FONT></CENTER><HR>\n ,, ; 

15 

/ /transtype, time, date, acct #, expire, vpos id, transaction type, auth 
code, ref#, amount 

//Soft goods fulfillment 
20 char *pszSoftUrl = clWSINT.LookUp("soft_url"); 

if (pszSoftUrl) 

clWSINT « pszSoftUrl « "<HR>"; 

#ifdef_SC 

25 / /Static Gso, placeholder crap until do LnGrp 

C lBkGso.ToHtml(clWSINT, NOEDIT); 
clWSINT « "<HR>"; 

. . . //Static Billing _._ 

StaticBillHtml(clWSINT, clProfile); 
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clWSINT « "<HR>"; 
//Static Shipping 
StaticShipHtml(clWSINT, clProfile) ; 
clWSINT «-"<HR>"; 

#else 

/ /Static passed gso if it exists 

char *pszGso - clWSINT.LookUp("gso_opaque"); 

if (pszGso) clWSINT « pszGso; 

//Static Billing 

StaticBillHtml(clWSINT, clProfile); 
clWSINT « "<HR>"; 

#endif 

//Merchant Signature Block (if/when applicable) 
//Buttons 

char *pszHomeUrl = clWSINT. LookUp("home_urr); 
char *pszShopUrl = clWSINT.LookUp(*'shop_urr); 
clWSINT « "<CENTER> \n< A HREF = " « pszShopUrl 
« "> <IMG SRC=" « clReg.m_szReturnShop « " BORDER = 
0></A>\n" 

« "<A HREF = " « pszHomeUrl « "> <IMG SRC=" « 
clReg.m_szHome « " BORDER = 0></A>\n" 
« " < / CENTER> < H R> \ n" ; 

//Acquirer Banner 

char szPANLo[ACCT_NUM_SZ + 1], szPANHi[ACCT_NUM_SZ + 1], 

szBufIMAX_PATHj^l]; 

char szTruncPAN[ACCT_NUM_SZ+l] ; 
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HKEY hCardsKey, hCardKey; 
DWORD dwtype, dwlen; 
int nNoCards, nPANLen; 
long retCode; 

RegOpenKeyEx(clReg.m_hStoreKey, "API\\CDT", 0, KEY_READ, 

&hCardsKey); 

dwlen = sizeof(int); 

RegQueryValueEx(hCardsKey, "NoOfRows", 0, Ssdwtype, 
(LPBYTE) &nNoCard s , &dwlen); 

for (int i = 0; i < nNoCards; i++) { 

RegEnumKey(hCardsKey, i, szBuf, MAX_PATH + 1); 
RegOpenKeyEx(hCardsKey, szBuf, 0, KEY_READ, MiCardKey); 
dwlen = ACCT_NUM_SZ +1; 

retCode = RegQueryValueEx(hCardKey, "PANLo", 0, &dwtype, 

(LPBYTE) szPANLo, &dwlen); 

if (retCode != ERROR.SUCCESS) return; 
dwlen = ACCT_NUM_SZ + 1; 

retCode = RegQueryValueEx(hCardKey, "PANHi", 0, &dwtype, 

(LPBYTE) szPANHi, &dwlen); 

if (retCode != ERROR_SUCCESS) return; 
nPANLen = strlen(szPANLo) ; 
strncpy(szTruncPAN, szPan, nPANLen); 
szTruncPAN [nPANLen] = '\0' ; . 

if((atoi(szTruncPAN) >= atoi(szPANLo) ) && (atoi(szTruncPAN) < 
atoi(szPANHi))) { 

char szAcquirer[MAX_PATH + 1], 
szAcquirerBanner[MAX_PATH + 1]; 

szAcquirer[0] = NULL; szAc quirerBanner[0] = NULL; 

HKEY hAcquirersKey, hAcquirerKey; 



\51 
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int nNoAcquirers = 0; 
dwlen - MAX.PATH + 1; 

RegQueiyValueEx(hCardKey, "Acquirer", 0, &dwtype, 

(LPBYTE) szAcquirer , &dwlen); 

RegOpenKeyEx(clReg.m_hStoreKey, "API\\ADT", 0, 

KEY_READ, &hAcquirersKey); 

dwlen = sizeof(int); 

retCode = RegQueryValueEx(hAcquirersKey, "NoOfRows", 
0, &dwtype, (LPBYTEJ&nNoAcquirers, &dwlen); 

for (int j = 0; j < nNoAcquirers; j++) { 

retCode = RegEnumKey(hAcquirersKey, j, szBuf, 
MAX_PATH +1); //Get jth Acquirer subkey in szbuf 

if (retCode != ERROR_SUCCESS) break; 
if (!strcmp(szBuf, szAcquirer)) { 

RegOpenKeyEx(hAcquirersKey, szBuf, 0, 

KEY_READ, &hAcquirerKey); 

dwlen = MAX_PATH +1; 
retCode = RegQueryValueEx(hAcqiiirerKey, 
"AcquirerBanner", 0, &dwtype, (LPBYTE)szAcquirerBanner, &dwlen); 

if (retCode != ERROR_SUCCESS) break; 
clWSINT « "<CENTERxlMG SRC=" « 

szAcquirerBanner « "></CENTER>\n"; 

RegCloseKey(hAcquirerKey); 

break; 

} 

} 

RegCloseKey (hAcquirersKey) ; 

_break; 

} 

\5« 
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RegCloseKey (hCardKey) ; 

} 

RegClo seKey(hCardsKey) ; 
clWSINT << - </HTML>"; 

} 



iiiiiiiiiiiiiiiiiiiinimuuinmiiiiiiiiiiiinnmiiniii 
i 

1/ VposPay 

/ / Create a PO object and invoke the vpos 

/////////////////////////////////////////////////// /////////// 
I 

EStatus VposPay(CWSINT& clWSINT, CRRReg& clReg) { 

EStatus eStat; 
EPCLTransType eTxn; 

char *psZTxn = clWSINT.LookUp("transaction"); 

char szBuflMAX_CGI_VAR + 1]; //used for cgi variable tstore and for 
number later 
#ifdef_SC 

CPOLBk clBkGso; //GSO data structure 

#else 

/ /Total for transaction 
char *ps^Total = clWSINT.LookUp("total"); 
if (Ips^Total) return (eRRNoPayTotal); 
#endif __. _ - 



1^ 
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//Profile object 

CProf *pProfile; 

pProfile = new CProf(); 

if (IpProfile) -return (eRRNewFailed); 

eStat = pProfile->Init(clWSINT); 

if (eStat != eSuccess) return (eStat); 

/ /Check billing information 

if (!(pProfile->m_b_name[0] && pProfile->m_b_addrl[0] && pProfile- 
>m_b_city[0) && pProfile->m_b_state[0] && 

pProfile->m_b t _zip[0] && pProfile->m_b_country[0] && pProfile- 

>m_b_phone[0) && 

pProfile->m_b_cardlO] && pProfile->m_b_expire_month[0] && 

pProfile->m_b_expire_year[0])) { 

eStat = DisplayPayPage(clWSINT, clReg, TRUE); 
return eStat; 

} 

/ /Payment transaction for a credit card 
#ifdefVPOS_OLE 

CVPCL_01eCCAuthOnly *pTxn; 

#else 

CVPCLFinCCTrans *pTxn; 
#endif 



if (ps^Txn) { 

eTxn = eNumTransTypes; 
if (!strcmp("authonly", pszTxn)) 
eTxn = eTransAuthOnly; 
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/* if (!strcmp("authcapture M , pszTxn)) 

eTxn = eTransAuthCapture; 
if (!strcmp("offlineauth", pszTxn)) 
eTxn = eTransOfflineAuth;*/ 

} 

else 

eTxn = clReg.m_eDefaultAuthTrans; 

/ /Create Transaction object 

switch (eTxn) { 

case eTransAuthOnly: 

#ifdefVPOS_OLE 

pTxn = new CVPCL_01eCCAuthOnly(); 

#else 

pTxn = new CVPCL_CCAuthOnly() ; 
#endif 

if (IpTxn) return eFailure; // Transaction Init Failure 

break; 
default: 

return eRRIUegalTransaction; 

} 

/ /Transaction Initialize 

char *pszMerchant - clWSINT.LookUp("store"); 
sprintf(szBuf, "MerchName="); 

strncat(szBuf, pszMerchant, (MAX_CGI_VAR-10)); //The 10 is for 
MerchName= 

/ / Connect to the OLE Automation Server 
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#ifdefVPOS_OLE 

eStat = pTxn->CreateDispatch() ; 
if (eSuccess != eStat) { 
return eFailure ; 

} 

#endif 

eStat = pTxn->InitTrans(szBuf); 

if (eStat != eSuccess) return eFailure; //eRRTxnlnitFailed 
//GSG Number 

char* b_gso_num = clWSINT.LookUp("b_gso_num"); 
if (!b_gso_num) return (eRRNoGsoNum) ; 
//Compose Gso object 
//CPOLPO clPO(&b_gso_num); 

/ /Creates shopping basket from CGI/Cookies. This information is 
borrowed by 

/ /Line Group class. For each item in the basket, put it in the PO 
object. We use a member function 

/ /That others using the library cannot use because they may not have 
a basket object at their disposal. 

/ /Those others must use the Set methods directly 

/ /Then get prices from database. If prices differ, error code 
#ifdef_SC 

eStat = clBkGso.Init(clWSINT, *pProfile, clReg); 

if (eStat != eSuccess) return (eStat); 
/ / eStat = clPO.InitFromBk(clBkGso); 

if (eStat 1= eSuccess) return (eStat); , 

#endif 
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/ /set all stuff from profile object 
//set custcookie 
//setcustid 
/ /set personal message 
5 //Pay Page standalone. Call an integrator function, execute vpos 

stuff, call an ending function. 

/ /The calls before and after are for the integrator to reconcile his 

database with the VPOS. 

10 / /GSO VERIFICATION suggestions 

/ /Check to see if this purchase order exists in the database & if it is 
linked properly with this price 

/ /Insert GSO and line items into db with before VPOS Txn status 
/ /eStat = GsoVerify(b_gso_num, pszTotal); //For integrator to fill in. 

15 //if (eStat != eSuccess) return eStat; //Failed lookup check 

#ifdef _SC 

intnTot; 

/* nTot = clBkGso.GetTot() * 100; 
20 if (((clBkGso.GetTot() * 100) - nTot) >= .5) 

++nTot; 

sprintf(szBuf, "%.2f, nTot/ 100.0) ; //Transaction Amount, hack to 

get past 2 digits*/ 

/ /erase szBuf below. Lose precision by flooring this integer, need to 

25 define round up/down 

sprintf(szBuf, "%d", (int)clBkGso.GetTot()); 
pTxn->SetReqTransAmt(szBuf, (EPCLCurrency) 

. clReg.nueDefaultC.urrency, eTwoDecDigits); __ .__ 

#else 



WO 98/37675 



PCT/US98/03236 



/ /Amount 

NumClean(pszTotal); 

pTxn->SetReqTransAmt(pszTotal, (EPCLCurrency) 
clReg.m_eDefaultGurrency, eTwoDecDigits); 

#endif 

//GSO Num 

pTxn-> SetPurchOrderNum(b_gso_num) ; 
/ /Retry Counter 

pTxn->SetRRPid(l); //The first time a transaction is executed this 

must be set to 1 

/ /AVS Data 

if (clReg.m_nAVS) { 

char avs_zip[ZIP_SZ +1]; 

strncpy(avs_zip, pProfile->m_b_zip, ZIP_SZ); 

avs_zip[ZIP_SZ] = NULL; 

NumClean(avs_zip) ; 

pTxn-> SetAVSData(avs_zip) ; 

} 

pTxn->SetBName(pProfile->m_b_name); 

pTxn->SetBStreetAddressl(pProfile->m_b_addrl); 

pTxn->SetBStreetAddress2(pProfile->m_b_addr2); 

pTxn- > SetBCity (pProfile-> m_b_city) ; 

pTxn->SetBStateProvince(pProfile->m_b_state); 

pTxn->SetBZipPostalCode(pProfile->m_b_zip); //Insert as is zip into 

db 

pTxn->SetBCountry(pProfile->m_b_country); 
pTxn->SetBEMail(pProfile->m_b_email); 
pTxn->SetBDayTimePhone(pPrpme->m_b_phone); 
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//Card. Number and expiry date 
NumClean(pProfile->m_b_card) ; 
char szDate[DB_MONTH_SZ + DB_YEAR_SZ + 1]; 
strncpy(szDate, pProffle->m_b_expire_month, DB_M ONTH_SZ) ; 
5 szDate[DB_MONTH_SZ] = NULL; 

strncat(szDate, pProfile->m_b_expire^ear, DB_YEAR_SZ); 
pTxn- > SetPAN(pProfile->m_b_card) ; 
pTxn->SetExpDate(szDate); 

10 / / Execute Transaction 

eStat = pTxn->ExecuteTrans(); 

if (eStat != eSuccess) return eStat; //DB or Internal Error of some 

kind 

15 / /Transaction Shutdown 

eStat = pTxn->ShutDownTrans(); 

if (eStat != eSuccess) return eFailure; //eRRTxnShutFailed 

/ /Gso after for integrator to fill in 
20 / /Gso_reconcile(success or failure, gso_number); 

/ /Delete cookies GSO. Set shipping/ billing cookies. Send receipt - 
member function of PO object. 
#ifdef_SC 

25 VposReceipt(clWSINT, pTxn, *pProfile, clReg, clBkGso); //This should 

be PO object 
#else 

VposReceipt(clWSINT,.pT^_,*pPrpfile, clReg); //Use Get Methods for_ 
Receipt 

\lp5 
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#endif 

#ifdefVPOS_OLE 

/ / Disconnect from the server 
pTxn->ReleaseDispatch() ; 

5 #endif 

return (eSuccess); 

Default Gateway Configuration 

10 The VPOS is initially shipped enabled to connect to a default gateway with a 
single instance of a gateway defined that accesses a predefined site for 
testing of an installation before bringing it online in a production mode. The 
test installation contacts and converses with an actual gateway that 
simulates live transactions. After the installation checks out utilizing a set 

15 of test transactions, the test gateway downloads the pre-checked 
customizations to the installation so that it can switch over to the 
production acquirer. This download processing is enabled in extensions to 
SET. 

20 Internet Transaction Gateway 

Payment methods that issue cards for conducting business utilize four 
major entities. These entities are the issuer, consumer, merchant and the 
acquirer. The issuing bank that provides the consumer with a credit card 
are usually not the same bank as the acquiring bank that serves the 
25 merchant. When the consumer utilizes a credit card to pay for a purchase, 
the merchant swipes the card through the POS terminal which makes a 
connection to the merchant's acquirer via the telephone network and 

transmitsan authorization request with data read from the magnetic stripe. 

The acquirer's host processor, depending on the card number, will either 
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perform local processing or switch the request to the correct issuing bank's 
host processor through the interchange network. In a few seconds, the 
authorization response is returned to the originating POS indicating either 
an approval or a rejection. 

5 

The Internet is a viable infrastructure for electronic commerce. Ubiquitous 
browser software for the World Wide Web provides around-the-clock access 
to a large base of information content provided by Web servers. Utilizing a 
preferred embodiment, consumers using browsers can shop at virtual stores 
10 and malls presented as Web pages managed by the merchants' servers. 
Consumers can make purchases and pay for them using credit cards or 
other digital payment instruments in a secure manner. For such Internet- 
based payments to be authorized, a "gateway" is necessary at the back end 
to channel transactions to legacy processors and interchange networks. 

15 

Figure 21 is a detailed diagram of a multithreaded gateway engine in 
accordance with a preferred embodiment. Processing commences when a 
TCP transaction 2100 is received by a HTTPS Server 2102 and parsed to an 
appropriate Web Adaptor 2104 which posts an encrypted set transaction to 

20 the multithreaded gateway engine 2110. The encrypted SET request is 

received at a decryptor 2120 and decrypted into a standard SET transaction 
for converting by the forward converter 2124. The converted transaction is 
passed to the socket multiplexor 2130 to communicate via an existing 
communication link 2140 to a host computer. A security logger 2150 is 

25 also utilized for passing security records back via a database server 2160 to 
a database administration application 2190. A transaction logger 2155 also 
utilizes the database server- 2160 to capture transaction logsin a_ database. 
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2180. Other system administration tasks 2195 include a web server 
administration task 2190 which logs web hits in a log 2170. 

Figure 22 is a flow diagram in accordance with a preferred embodiment. 
5 Processing flows from customers 2200 that are paying for products over the 
internet or other communication medium utilizing HTTPS or other protocols 
to one or more merchants 2210, 2220 or 2230 to a gateway 2240 which 
directs transactions to a particular host processor 2250 for authorization 
processing in accordance with the present invention. 

10 Internet Payment Authorization 

The Gateway is a secure computer system that mediates transactions 
between the merchants' servers and a payment processor. The Gateway 
supports secure communications between merchants using the Internet on 
one side, and a processor using standard secure financial networks on the 

15 other side. Between the two interfaces, the Gateway maintains a detailed 
log of all transactions, whether in-progress, completed, or failed. The 
Gateway accepts transactions from merchants and converts them to Internet 
compatible formats before forwarding them to the host processor. 
Responses from the host, after the reverse conversions, will be returned to 

20 the originating merchants. 

The Gateway performs many functions, including: 

• Receives encrypted credit card transactions from the merchants via 
the Internet 

• Unwraps and decrypts transactions 

~25 • Authenticates digital signatures of-transactions based on certificates - 

• Supports all transaction types and card types 
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• Accepts concurrent transactions from each of the merchant servers 

• Converts transaction data to internet formats; forwards the mapped 
requests 

(in the clear) to a payment processor 

5 • Converts transaction responses, correlates them with the original 
requests, and sends the mapped responses back to the merchants 

• Provides logging, monitoring, reporting, and system administration 

Figure 23 illustrates a Gateway's 2330 role in a network in accordance with 
a preferred embodiment. The Gateway 2330 strictly conforms to all SET 

10 stipulations regarding certificate management, PKCS signed data 

encapsulation, PKCS encrypted data encapsulation, ASN. 1 representation, 
DER encoding, MIME encapsulation, and message sequencing. A merchant 
server 2300 communicates via the Internet 2310 using the SET protocol 
2320 through a gateway server 2330 using a network interface processor 

15 2340 to communicate to a legacy network 2360 in, for example the X.25 
protocol 2350. The legacy host 2370 ultimately receives and processes the 
transaction from the merchant server 2300 without modification to its code. 

Internet Communication Protocols 

As discussed above, the TCP/IP protocol suite is utilized at the transport 
20 level. At the application level, in compliance with SET, all requests arrive at 
the Gateway in HTTP format. Similarly, all responses from the Gateway to 
the merchant servers will be transferred in HTTP. The HTTP protocol 
stipulates that a request-response pair will go through the same TCP 
connection and that the originator, in this case a merchant server, will 
25 establish a connection to send the request and will take down the 
connection when it has received the response. 
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Host Payment Protoc Is 

Message conversions performed by the Gateway will be significantly more 
than format transliterations: per-protocol differences in data elements and 
message semantics must be considered carefully. The various transaction 
5 types that are supported are listed below. 

Credit card sale with capture 
Credit card sale without capture 

Credit card sale with capture including AVS (MasterCard and ~~ 
VISA) 

Credit card sale without capture including AVS (MasterCard and 
VISA) 

Credit card return (Credit) 

Credit card post authorization (Force Post) 

Credit card post authorization (Force Post) with partial reversal 

support, enhanced authorization data, and AVS result code 

(VISA) 

Credit card sale with capture - Void 
Credit card return (Credit) - Void 
Totals request (for balancing) 



Host Communications Protocols 

A virtual, private network between the Gateway and the host processor is 

10 established to expedite hos t com munication. In addition, two Network_ 

Interface Processors (NIP)s - a "near end" NIP that interfaces to the Gateway 
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and a "far end* NIP that interfaces to the host. The NIPs will handle virtual 
connections between themselves. The far-end NIP will take care of specific 
communication details. The near-end NIP is an IP-addressable device that 
converts between-TCP messages and packets. It is installed on the Red Net 
5 2330, which is a LAN outside the corporate firewall. The Gateway, on the 
Blue Net 2330, utilizes TCP/IP 2320 to communicate with the near-end NIP, 

GATEWAY FEATURES 

Because the Gateway must sustain reliable operations and enable graceful 
evolution, it is designed with some important attributes, including: 
10 Security, Availability, Performance, Scalability, and Manageability. 

Security 

Channel Security 

At the application level, SET provides signed and encrypted data 
encapsulations of payment information portions of the transaction 
messages. Transport- level encryption of the entire message packet is 
required for additional security. The HTTPS protocol - i.e., HTTP over SSL 
3.0 - is utilized between the merchants and the Gateway. The virtual 
connections between the near-end NIP and the host are part of a private 
network. The termination will occur outside the firewall. Data between the 
Gateway and the host is sent in the clear with no encryption. In this 
network configuration, a transaction between a merchant's VPOS and the 
host will cross the firewall four times: SET request from VPOS to Gateway, 
legacy request from Gateway to NIP, LEGACY response from NIP back to 
Gateway, and SET response from Gateway back to VPOS. 

— 25 Certificate-Management 

Payment Protocol C rtificates 

HI 



15 



20 
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The Gateway uses certificates to authenticate the two parties involved in 
each MOSET transaction. Through a Certificate Authority, one certificate is 
issued for the Gateway and one certificate for each of the merchant servers. 

Secure Channel Certificates 

5 SSL will require separate certificates for the Gateway and the merchants. 

Availability 

Site redundancy and location redundancy allows the Gateway to sustain 
service through virtually instantaneous recovery from internal failures or 
external disasters that cause physical damages to the system. Minimum- 
10 outage recovery is possible with redundant configurations of important 
components. 

Site Redundancy 

The Gateway supports connections to a proprietary bank network and 
supports mirrored disk arrays. 

15 Location Redundancy 

The Gateway architecture supports location redundancy where a secondary 
remote system is connected to the primary system via dedicated WAN links 
for software-driven database duplication. 

Scalability 

20 The Gateway software architecture, the choice of third-party software 

components, and the selection of hardware platforms enable the system to 
gracefully adapt and evolve to take on new demands in different dimensions. 

The Gateway resides on an HP 9000 that is housed in a standard 19" EIA 
rack. 



\1> 
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Gateway Hardware Configuration 











K-Class SMP Server - Model K420 - Standard Configuration 


120 MHz PA-RISC 7200 CPU 


128 MB ECC RAM 


Built-in I/O includes Fast/Wide/Differential SCSI-2, EtherTwist 
802.3 LAN, AUI, RS-232C Connectors, Centronics Parallel Port, 
and Internal Modem 


650 MB CD-ROM Drive 


HP-UX 10.10 Operating System (with two-user license) 


4HP-PBSlots 


Additions 


1 


SCSI-2 Disk Controller 

to support disk mirroring over dual SCSI-2 buses 


1 


2 GB Internal SCSI-2 Disk Drive, 20MB/s transfer rate, not 
mirrored 

for systems software and swap space 


1 


4 GB External High-Availability Disk Arrays 

for databases - total of 4x2 MB modules required 


1 


4 GB DAT drive with data compression 


1 


HP-PB Slot Expansion Option 

provides 4 additional HP-PB slots for peripheral controllers 


2 


FDDI interface cards (each card uses 2 HP-PB slots) 



V73 
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1 Option for eight-user license for HP-UX 



Cryptographic Hardware 

The encryption and decryption algorithms used in processing SET/SSL 
messages require significant computational power. A "security processor" is 

5 deployed with the Gateway to boost the performance of cryptographic 

algorithms. The processor is a networked peripheral device to the HP 9000 
server. It provides cryptographic services suitable for SET/ SSL processing, 
and its services are accessible via calls to software libraries running on HP- 
UX. Figure 24 is a block diagram of the Gateway in accordance with a 

10 preferred embodiment. 

Gateway Architecture 



Operating System Software 

The Gateway runs under the HP-UX Version 10. 10 operating system and is 
upgraded to support future significant system releases. HP-UX 10.10 
15 conforms to major standards, including: 

• X/Open UNIX 95 (conforming with the Single UNIX Specification, SPEC 
1170) 

• X/Open Portability Guide Issue 4 Base Profile (XPG4) OSF AES 

• IEEE POSIX 1003.1 and 1003.2 

20 • AT&T System V Interface Definition (SVID3 base and kernel extensions 
subset) Level 1 API support 
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• UC Berkeley Software Distribution 4.3 (BSD 4.3) including such features 
as job control, fast file system, symbolic links, long file names, and the C 
shell 

• System V.4 File System Directory Layout 

5 This compliance with various software standards assures that while a 

preferred embodiment of the invention is disclosed in association with a best 
mode of practicing the invention other similar software and hardware 
environments can be readily substituted without undue experimentation. 

Relational Database Management System (RDBMS) Software 

10 The Gateway uses Oracle7 Server version 7.3 as the RDMBS and will be 
upgraded to use future significant system releases. The multi-threaded, 
multi-server architecture of Oracle7 provides applications with scalability to 
high-volume transaction workloads. When deployed with the HP 9000 K- 
Class platform, Oracle7 performs a symmetrically parallel database 

15 operation across all available processors. In addition, Oracle7 includes 
options for creating high-availability systems: 

• The Oracle7 Parallel Server option extends the reliability of applications 
by transparently harnessing the power of clustered computers in a single 
logical processing complex that can tolerate individual machine failures. 

20 • Oracle7 Symmetric Replication provides high data availability. Data can be 
replicated from the primary System to one or more alternative sites. 

HTTP Server 

The Gateway utilizes Netscape's Enterprise Server 2.0 as the HTTP server. 
The server is designed for large-scale Internet commerce deployment, 
Enterprise Server 2.0 achieves performance and reliability with such 



25 
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features as optimized caching, SMP support, enhanced memory 
management, and SNMP-based performance monitoring. Efficient process 
management features minimize system load and increase server reliability. 
Security features- are provided using the SSL 3.0 protocol. 

5 Protocol Stacks 

Internet and LAN - The TCP/IP protocol stack will be provided as part of the 
HP-UX operating system. 

Other Application-Level Protocols 

Application-level protocols enable client- server interoperability. Each of the 
10 following protocols are transported using TCP or UDP. 

• HTML. HTML will be used to define screens for Gateway system 
administration. 

• HTTP. The HTTP layer is part of Enterprise Server 2.0. The server is 
administered with a Web browser. 

15 • SQL*Net. The Gateway's Oracle7 database can be accessed by 
administration clients using SQL*Net. Administration software can 
establish database connectivity to retrieve data for generating transaction 
reports. 

• SNMP. Enterprise Server 2.0 can be monitored using SNMP. The 
20 Gateway utilizes SNMP for remote system management. 

Transaction Performance Monitoring and Measurement 

• The "hits" performance indicators are available from the Web server. 
Statistics can be generated at any time to highlight the load pattern or to 
pinpoint the time" when the server was most~active. — 
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• Gateway statistics about transaction requests (by transaction type) and 
transaction results (e.g., success, failed due to host, failed due to 
authentication, etc.) can be determined at any time for a particular time 
interval by generating a report. 

The Gateway is upgradeable to interoperate with a real-time event 
monitoring system such as OpenVision's Performance Manager. 

Basic Request/ Response Mappings 

The following table shows the basic request/ response mapping between the 
SET protocol and the LEGACY protocol. 



llllffi 


||j!%^a&^ 


AuthReq, AuthRes 


LEG/CTR (05) 


AuthRevReq, 
AuthRevRes 


not supported 


CapReq, CapRes 


LEG/CTR (42 or 44) 


CapRevReq, 
CapRevRes 


LEG/CTR (41) 


CredReq, CredRes 


LEG/CTR (40) 


CredRevReq, 
CredRevRes 


not supported 


BalReq, BalRes 


CTA/CTL (48) 
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Detailed Message Fi Id Mappings 

The following sections map the fields in LEGACY messages to fields in SET 
messages. The names of the SET fields are the names used in the SET 
ASN. 1 specification. The full scope of the SET fields is listed in order to 
5 remove any ambiguity (but does not necessarily reflect actual naming 
conventions in source code). 

LEGACY - Authorization Request Record (LEG) 



(a) Host Processing 


IIBSft WM-^£s i8filfiBfi!iHSIill 

'h^d-coded litGat^ay to""^RI" 


Address 




(b) Record Type 


hard-coded at Gateway to "LEG" 


(c) Control 


hard-coded at Gateway to 6 


(d) Originating 


from Merchant Certificate in unwrapped SET 


Merchant Number 


request 


(e) Sequence Number 


generated at Gateway 


(f) Original Sequence 


generated at Gateway 


Number 




(g) Date and Time of 




Original Transaction 




05 • CC Authorization 


AuthReq . AuthReqDate 


Request 




40 - CC Capture 


CredReq . CredDate 


Credit 




41 - CC Capture Void 


CapRevReq . CapRevDate 
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42 - CC Capture Post j CapReq . CapDate 

j 

(nonAVS) 


44 - CC Capture Post \ CapReq . CapDate 
(AVS) | 


76 - CC Authorization j This transaction code will not be used. 
Reversal j 


(h) Device ID - part 1 j hard-coded at Gateway to binary zeros. 


(i) Device ID - part 2 


The Terminal-id generated by Merchant 
System and delivered to the Gateway 
software as a result of decoding the SET 
request. 


(j) Transaction Code 




05 - CC Authorization 
Request 


AuthReq received 


40 - CC Capture \ CredReq received 
Credit j 


41 - CC Capture Void \ CapRevReq received 


42 • CC Capture Post 
(nonAVS) 


CapReq received (if CapReq . RespData . 
AVSResult is blank) 


44 • CC Capture Post 
(AVS) 


CapReq received (if CapReq . RespData . 
AVSResult is non-blank) 


76 - CC Authorization 
Reversal 


This transaction code will not be used. 


(k) Alphabetic Card 


computed at Gateway from PAN 
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Issuer Code 




05 - CC Authorization \ 


AuthReq . PI . PANData . PAN 


Request 




40 - CC Capture 


CredReq . RespData . CapToken . 


Credit 


TokenOpaque . PAN 


41 - CC Capture Void \ 


CapRevReq . RespData . CapToken . 




TokenOpaque . PAN 


42 - CC Capture Post \ 


CapReq . RespData . CapToken . 


(nonAVS) 


TokenOpaque . PAN 


44 - CC Capture Post \ 


CapReq . RespData . CapToken . 


(AVS) 


TokenOpaque . PAN 


76 - CC Authorization \ 


This transaction code will not be used. 


Reversal 




(1) Authorization 




Amount 




05 - CC Authorization 


AuthReq . AuthReqAmt 


Request 




40 - CC Capture 


CredReq . CredReqAmt (could be different 


Credit 


than CapToken) 


41 - CC Capture Void 


CapRevReq . CapRevAmt 


42 - CC Capture Post 


CapReq . CapReqAmt 


(nonAVS) 




44 -CC Capture Post 


CapReq . CapReqAmt 


(AVS) 
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SIS = J 


76 - CC Authorization \ 


This transaction code will not be used. 


Reversal 




(m) Cash Back 


hard-coded to "00000000* (EBCDIC) 


Amount 




(n) Card or Driver's 




License Data 

i 




05 - CC Authorization \ 




Request 


AuthReq . PI . PANData . PAN 


Account Number 


AuthReq . PI . PANData . CardExpiration 


Expiry Date 




40 - CC Capture 




Credit 


CredReq . RespData . CapToken . 


Account Number 


TokenOpaque . PI . PAN 


Expiry Date 


CredReq . RespData . CapToken . 
TokenOpaque . PI . CardExp 


41 - CC Capture Void j 




Account Number 


CapRevReq . RespData . CapToken . 


Expiry Date 


TokenOpaque . PI . PAN 
CapRevReq . RespData . CapToken . 
TokenOpaque. PI . CardExp 


42/44 - CC Capture 




Post (non AVSorA VS) 


CapReq . RespData . CapToken . 


Account Number 


TokenOpaque . PI . PAN 


Expiry Date — 


CapReq rRespData . CapToken . 



1*1 



WO 98/37675 



PCT/US98/03236 



•|i|||i^|^g^|i: ; T 


J 


\ TokenOpaque . PI . CardExp 


76 - CC Authorization j 


This transaction code will not be used. 


Reversal 




(o) Additional Data 


05 - CC Authorization j 




Request 


AuthReq . AVSData . ZIPCode (if VISA Card) 


ZIP Code 


blank (ifnon VISA Card) 


40 - CC Capture \ 




Credit 


CredReq . RespData . LogReflD 


WFB Reference 




Number 




4i - CC Capture Void 




WFB Reference 


CapRevReq . RespData . LogReflD 


Number 




42 - CC Capture Post 




Authorization 


CapReq . RespData . AuthCode 


Code 




44 - CC Capture Post 




AVS 


CapReq . RespData . CapToken . 


(p) CPS ACI Flag 


TokenOpaque . CPSAciFlag 


(q) CPS 


CapReq . RespData . CapToken . 


Transaction ID 


TokenOpaque . CPSTransId 


(r) CPS 


CapReq . RespData . CapToken . 


Validation Code 


TokenOpaque . CPSValCode 
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(s) Visa Response \ 


CapReq . RespData . CapToken . 


Code 


TokenOpaque . VisaRespCode 


(t) Merchant 


CapReq . RespData . CapToken . 


Category Code 


TokenOpaque . MerchantCatCode 


(u) Entry Mode 


CapReq . RespData . CapToken . 


(v) Original 


TokenOpaque . EntryMode 


Authorization Amount ; 


CapReq . RespData . CapToken . AuthAmt 


(w) AVS Result 


CapReq . RespData . AVSResult 


Code 


CapReq . RespData . AuthCode 


(x) Authorization 




Code 




76 - CC Authorization \ 


This transaction code will not be used. 


Reversal 





LEGACY - Authorization Request Response (CTR) 

The field Settlement Date is returned by the host in a LEGACY 
5 Authorization Request Response (when a transaction is force posted). 

This Settlement Date field contains the day that a posted transaction will 
be settled between the Merchant and the Acquiring Bank. Since WFB wishes 
that this date be made available to the Merchant for the purposes of 
financial record keeping this field must be returned to VPOS. 



W3 
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This field is not currently returned in any SET response message. The 
Payment Protocols Team must make a recommendation on how this data is 
to be returned by the Gateway to VPOS. 



(a) Host Processing 


! echoed by host, not included in SET 


Address 


| response 


(b) Record Type 


| echoed by host, not included in SET 
j response 


(c) Control 


j echoed by host, not included in SET 

| response j 


(d) Settlement Date 


| TBD by Payment Protocols Team 


(e) Sequence Number 


| echoed by host, not included in SET 

| response j 


(f) Original Sequence 


| echoed by host, not included in SET j 


Number 


j response j 


(g) Account Indicator 


| not included in SET response 


(h) Device ID - part 1 


| echoed by host, not included in SET j 

j • 

| response 


(i) Device ID - part 2 


| echoed by host, included in SET response in [ 

| a location to be determined by the Payment j 

! Protocols Team. The value echoed is the 

j 1 

| terminal-id as delivered in the SET request, j 


(j) Action Code 


j The Action code returned in the LEGACY j 




: j 

| response will be combined with the Error ] 
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| Code (if present) and translated to a | 




| canonical list of error codes. See section 0 




! for exactly where this canonical error code j 




I will be returned for each transaction type. 


(k) Transaction Code 


| echoed by host, not included in SET 




1 response j 


(1) Authorization 




Amount 




05 - CC Authorization 


| AuthResPayload . AuthAmt (if Saleslnd = j 


Request 


| False) j 




! SaleResPayload . CapAmt (if Saleslnd = j 




1 True) 1 


40 - CC Capture Credit 


j CredRes . CredResSeq . CredResItem . j 




| CredActualAmt j 


41 - CC Capture Void 


| CapRevRes . CapRevSeq . CapRevResItem . 




| CaptureAmt j 


42 - CC Capture Post 


| CapRes . CapRevSeq . CapResItem . 1 


(nonAVS) 


j CapResultPayload . CapAmt | 


44 - CC Capture Post 


I CapRes . CapRevSeq . CapResItem . 


(AVS) 


j CapResultPayload . CapAmt j 

...!.„ „ , i 


76 - CC Authorization 


| This transaction code will not be used. j 

i j 


Reversal 




(m) Authorization Code 


i : ! 

| j 


05 - CC Authorization 


1 AuthResorSale . RespData . AuthCode (if | 

; i 



\ts 
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m:i^st|!.^ 


Request 


SalesInd=False) 


i 

! 
i 




AuthResorSale 


. RespData . 


AuthCode (if 




SalesInd=True) 






(n) AVS Result Code 


AuthResorSale 


. RespData . 


AVSResult 


(o) Reference Number 


AuthResorSale 


. RespData . 


LOGRefld 


AVS Result Data 








only received if 








transcode = 05 and VISA | 








and 








approved but not 








captured 








(p) CPS ACI Flag 


AuthResorSale 


. RespData . 


CapToken . j 


* 


TokenOpaque . 


CPSAciFlag 




(q) CPS Transaction Id 


AuthResorSale 


. RespData . 


CapToken . 




TokenOpaque . 


CPSTransId 


i 

| 


(r) CPS Validation 


AuthResorSale 


. RespData . 


CapToken . 


Code 


TokenOpaque . 


CPSValCode 


(s) Visa Response 


AuthResorSale 


. RespData . 


CapToken . 


Code 


TokenOpaque . 


VisaRespCode 


(t) Merchant Category 


AuthResorSale 


. RespData . 


CapToken . 


Code 


TokenOpaque . 


MerchantCatCode 


(u) Entry Mode 


— 

AuthResorSale 


. RespData . 


CapToken . 




TokenOpaque . 


EntryMode 


i 
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Error Code Location in SET response messages 

The following table shows the explicit SET field in which the canonical 
error code will be returned in SET response messages. 

5 







:->Xy M3 JUf -:JL a : :^^MMV.*M? Jw. 




AuthRes 


AuthResorSale . RespData . RespCode 
(if Saleslnd = Falsel 

AuthResorSale . RespData . RespCode 
(if Saleslnd = True) 


AuthRevRes 


AuthRev will not be supported by the 
Gateway 


CapRes 


CapRes . CapResSeq . CapResItem . 
CapCode 


CapRevRes 


CapRevRes . CapRevResSeq . 
DraftCaptureStatus 


CredRes 


CredRes . CredResSeq . CredResItem . 
CredCode 


CredRevRes 


CredRev will not be supported by the 
Gateway 


BalRes 


to be defined by Payment Protocols 
Team 



l«1 
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Error Code Values in SET response messages 

The following table itemizes the proposed mapping of LEGACY specific action 
codes and error code pairs to the canonical error codes that will be sent in 
the SET response-messages. 
5 The canonical error response code values and descriptions were taken 
directly from " ISO 8583 : 1987 section 4.3.8 Table 7 ". 



VeriFone Proprietary SET Extensions 

10 The SET protocol currently has no provisions to support "Balance Inquiry 
requests. Balance Inquiry requests are used by the Merchant to query its 
Acquiring Bank as to various totals for the current days or past days 
transaction totals. 

The following two sections detail a proposed mapping between the LEGACY 
15 protocol and two new VeriFone proprietary SET extensions: Ballnq (Balance 
Inquiry) and BalRes (Balance Response). The Ballnq request is used by 
VPOS to query the Gateway as to the transaction totals and BalRes is the 
response sent by the Gateway to VPOS. 

LEGACY - Administrative Inquiry Record (CTA) 

20 











(a) Host Processing Address 


I hard-coded at Gateway to "VERF 


(b) Record-Type — ... 


| hard-coded at J3ateway_to/LEG w __ _ 


(c) Control 


| hard-coded at Gateway to "ACY» 



0 

SUBSTITUTE SHEET (RULE 26) 
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unwrapped SET request 



(e) Device ID - part 1 


hard-coded at Gateway to null-data 


(f) Device ID - part 2 


The Terminal-id generated by the 
Merchant System and delivered to 
the Gateway as a result of decoding 
the SET request. 


(g) Date and Time of Inquiry 


BalReq . InquiryTime 


(h) Sequence Number 


generated at Gateway 


(i) Transaction Code 


hard-coded at Gateway to "48" 


(j) Feedback Level 

10 - Totals online and offline 
for the Merchant 

20 - Totals online and offline 
for the Chain 


BalReq . FeedbackLevel 


<k) Feedback Day 

0 - Today 

1 - Yesterday 

2 - Two Days Back 

3 - Three Days Back 


BalReq . FeedbackDay 


(l) Feedback Type 

00 - All combined Visa and 
MasterCard Sales 
- 10 - MasterCard Net Totals - 


BalReq . FeedbackType 



1*1 



SUBSTITUTE SHEET (RULE 26) 
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20 - Visa Net Totals 




40 - Discover Totals 




50 - Amex Totals 




(m) Feedback ID 




Level 10:7 Digit Merchant 


I BalReq . Feedbackld 


Level 20: 5 Digit Chain 





SUBSTITUTE SHEET (RULE 26) 
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LEGACY - Administrative Resp nse Record (CTL) 











; (a) Host Processing Address 


; ecnoeu Dy nost, not inciuuea in ojm 




| response j 


„ — 

j (b) Record Type 


— ™$~«~™™,,™ . — , — > 

i ecnoea uy nost, not mciuaea in oH/i 




| response j 


i (c) Control 


; ecnoea oy nost, not mciuaea in oim ; 




1 response j 


| (d) Settlement Date 


j BalRes . SettlementDate | 


| (e) Sequence Number 


I echoed by host, not included in SET j 


1 


| response j 


| (f) Device ID - part 1 


j echoed by host, not included in SET 




| response j 


! (g) Device ID - part 2 


j The TermincLhid generated by the 




I Merchant System and delivered to 




I Gateway as a result of decoding the 




j SET request. j 


\ |tx| Action Code (U,D or r>) 


: i loos') 4-/"\ /A *»t*OT" , TYi \yy 17 rrr\r V\ 1 /"\TI7 

: uscu to ucLcrrninc E/irur luuc uciow 


| (i) Transaction Code 


| echoed by host, not included in SET 




| response 


| Additional Data 




| 0) Error Code 


! BalRes . BallnqResCode (see section 0) j 


| (k) Total Item Count 


! BalRes . TotalltemCount - - j 


| (l) Total Sales Amount (Credit 


j BalRes . TotalCCSalesAmount 



I'M 
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| (m) Totals Sales Item Count j BalRes . TotalCCCreditsAmount 

I (n) Total Credits Amount (Credit j BalRes . TotalCCCreditsItemCount 
| Card) | 
| (o) Total Credits Item Count (Credit j 
I Card) | 



Gateway Analysis for SET Message Handling 

This section tackles general design considerations of the Gateway software 
and is not limited to LEGACY (unless specifically mentioned). The complete 
functional behavior of the Gateway will be described in a separate 
document. 

Replay Attack Handling 

A replay attack at the Gateway is a request where either: 

a) the request is stale; the request was received "too late" with respect 
to the reqdate in the request. This window is specified by a 
configurable Gateway policy. 

b) the request is not stale but the exact rrpid (Request/ Response Pair 
Id) has already been seen before in a request and still logged in the 
Gateway database. The <xid, mid, rrpid> tuple will be the 
primary key that determine whether a request had already been 
received. This will allow the possibility of the same rrpid to be 

~- generated from the same merchant "but fdfaTxid and also allow the" 
same rrpid to be generated by a totally different merchant. 
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New Attempt vs. Retry Attempt 

It is possible that messages sent between the VPOS and Gateway may be 
lost in transit. This could happen either because of hardware/ software 
problems in the Internet or for hardware/ software reasons local to the 
5 Gateway or Merchant System. 

The question is then "How does a Gateway recognize an honest retry attempt 
from an initiator?* First a little background into the nature of a SET 
request. All SET requests have the following fields: 

xid merchant's transaction id 

10 mid merchant id (contained in certificate) 

tid terminal id (from Merchant System) 

rrpid request response pair id 

reqdate request date (from Merchant System) 
reqdata request specific data 

15 

Let the following, tuple represent a generic SET request: 
<xid, mid, tid, rrpid, reqdate, reqdata> 

The merchant establishes the xid during the shopping phase with the 
20 consumer. The same xid is used for both the AuthReq and the CapReq and 
subsequent CreditReq requests. Using the same xid for many requests 
makes it impossible for the Gateway to distinguish between repeated 
transactions vs. new transactions. 

25 For example, how could a Gateway possibly determine whether two valid 
CredJReq requests were to be interpreted as two individual credits or a retry 
of a single request. 
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(perhaps a CredReq for $10.00) 

request 2: <xid lf mid m9 tidt, rrpid 2 , reqdate 2 , reqdata^ 

(perhaps a new CredReq for $10.00) 

5 could also be interpreted as... 

request 1: <xidi, mid m , ttd t , rrpidi, reqdata, reqdatai> (perhaps a 

CredReq for $10.00) 
request 2: Oridj, mid m , tid t , rrpid 2 , reqdate 2 , reqdata x > (perhaps a retry 
10 of above) 

The reqdates are different in both cases because the date is generated along 
with the rrpid to thwart replay attacks. In this example the Gateway will 
not be able to determine whether the second CreditReq should be performed 

15 or whether it. is simply a retry to request 1 with rrpidi. The Gateway must 
know whether or not to apply a new credit or to deliver a response that it 
may already have from the host (it may have came too late for the first 
attempt or have been lost on the way to VPOS). If no response was logged 
from the host for request 1, the Gateway could repeat its original request to 

20 the host when receiving request 2. In a sense, the Gateway will act as an 
intelligent request/ response cache. 

The Gateway splits the rrpid number space into two parts. One main part 
that will remain the same for the same request across all its retry attempts 
25 and a smaller portion to indicate the number of retry attempts. Then, 

rrpidRetryCount = rrpid MOD MAXRETRIES + 1 (0 for initial request, 
> 0 for a re try) , 
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NOTE : The initial rrpids generated by VPOS software are equal to 0 MOD 
MAXRETRIES + 1 and in subsequent retries the lower order digits are 
incremented by one for each retry attempt. This requires extra stored in the 
5 VPOS application. The VPOS software must persistently store the rrpid 
used (which contains the retry count of the transaction) so that repeated 
attempts will follow the correct semantics. 

In general the Gateway will support the following logic [assuming the second 
10 request is fresh and not a replay attack]: 
If two requests, 

request 1 :<xidi, mid m , tid t} rrpidi, reqdatei, reqdatai> 
request 2 : <xidj, mid m , txdt, rrpid 2> reqdate2, reqdatai> 
are received at ti and t2 (where t 2 >ti) and, 
15 {rrpidi - (rrpidi MOD MAXRETRIES + 1)) s [rrpid 2 - (rrpid 2 MOD 

MAXRETRIES + 1)) 

then the Gateway will interpret the second request as a retry request. 
But if, 

[rrpidi - [rrpidi MOD 100)) * [rrpid 2 - [rrpid 2 MOD MAXRETRIES + 1)) 
20 then the Gateway will interpret the second request as a new request. 

In addition to being able to distinguish between a retry and a new request, 
the proposed rrpid scheme can be used to determine how many VPOS 
requests got lost in the Internet. This is a useful value-added service for 
25 system management. 

Robustness and Error Handling Issues 

There are several robustness issues that need to addressed. The basic flow 
is that VPOS sends a request to the Gateway, the Gateway logs the SET key 
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fields from the incoming attempt in the database. The Gateway then 
generates a host request which it logs completely in the database. The host 
handles the request and generates a response that is directed towards the 
Gateway which, when received is logged completely in the Gateway 
5 database. Finally the Gateway generates an SET response to VPOS, the 
contents of which is not logged in the database. 

If the Gateway has not received the request or receives the request but is not 
able to log the request in the database it is easily handled by a VPOS retry 
10 attempt. This recovery action needs no further discussion. In general, if the 
VPOS does not receive a reply to a request it has sent to the Gateway it must 
retry persistently until a response is received. All retry attempts from VPOS 
for the same request must have the same base portion of the rrpid but a 
different value in the retru counter . 

15 

The Gateway must handle replay attacks as outlined previously in this 
document. 

If the Gateway receives a request that it has already received from VPOS 
there could be several possible dispositions: 
20 a) the request had already been handled completely with the host and 

a host response is in the Gateway database. In this case the 
Gateway can simply translate the host response to a SET response 
and send it to VPOS. 
b) the request had been sent to the host before (as determined by a 
25 database field) but a response from the host is not on file. In this 

case the Gateway must retry the host request. 

If theJVPOS timesrOUt_for anyreason, it must retry later„using_an rrpid thaL. 
indicates a retry attempt. If the Gateway receives a late-response (after 
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VPOS has given up) it simply logs it in the database for that retry attempt (if 
no retry attempt for the transaction is still outstanding at the host). There is 
a glare situation where the original response could arrive so late that it 
could be confused with the response from a currently outstanding retry 
5 attempt with the host. This situation is logged and the first response not 
sent back to VPOS. 

A response from the host indicating a successful transaction may get lost on 
the way back to the Gateway or not be able to be logged in persistent storage 

10 in the Gateway. In either case VPOS is in a situation where the retry 

request when received by the host may result in a response from the host 
indicating that the request is a duplicate. The VPOS software must be able 
to handle this. In the LEGACY case when a duplicate post is received by the 
host the second one automatically causes the first one to void and the 

15 second transaction fails too. In this case VPOS should retry the transaction 
under a new rrpid. If the transaction goes through end-to-end all effects of 
the previous transactions will not matter. 

TokenOpaque Contents 

20 The Gateway requires information captured at the time of an AuthReq that 
must be repeated to the host at the time of the associated CapReq. The 
mechanism of choice (built into SET) for this is enabled utilizing this data in 
the TokenOpaque token of the CapToken which is sent in an AuthRes. This 
CapToken is stored at the Merchant system and represented to the Gateway 

25 at the time of the CapReq. The format of an TokenOpaque is an OctetString. 
The following general format (not specific to LEGACY) is proposed for 
capturing this information: 
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VersionRevision char(8) 



VersionName 



Field Nam 



PILength 



HostSpecDataLe integer 
ngth 

HostSpecData unsigned 



Field Data Type 

char(8) 



integer 

unsigned char (PILength) 



Explanation / Example 

e.g. "LEGACY" 

e.g. "1.0" (generally <major, 

minor >) 

length of PI data 

strongly encrypted 

length of host specific data 



host specific data 



char(HostSpecDataLength) 



Host Specific Data fLEGACY-only) 

For "LEGACY" version "1.0", it is proposed that newline seperated 
"name=value" pairs be used to store the host specific data. A null character 
will terminate the host specific data. The following host specific data (name 
value pairs) will need to be included: 



CPSACIFlag 

CPSTransactionld 

CPSValidationCode 

VisaResponseCode 

MerchantCategoryCode 



BrandID 



EntryMode 



NOTE: PI contains PAN and ExpiryDate. 
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Proposal forAVS Data Enc ding 

The "Address Verification" data element for the "Address Verification Service" 
(AVS) is defined in SET as an IASString. Each host may require different 
data to be sent to~use the AVS feature. The Gateway will need to be able to 
5 extract the information from this to inter-work with the legacy systems, A 
well-defined format for this data is required, an IASString blob is insufficient. 

The following data structure is utilized to deliver the AVS data.\ 

10 StreetAddress 1=800 El Camino Real\n 

StreetAddress2=Suite 400\n 

City=Menlo Park\n 

StateProvince=CA\n 

Countiy=USA\n 
15 PostOfficeBox=\n 

ZipPostalCode=94025\n 

\n 

An empty line indicates the end of AVSData. 
20 The detailed information that is available for the Address Verification Service 
depends on the Payment Window that captures the data from the consumer. 
The Merchant Systems Team defines the names that are used and the same 
names selected used globally. 

25 AVS Data (LEGACY-only) 

For "LEGACY" version a 1.0" only the ZipPostalCode name value pair is 
required. The Gateway will only use the first 5 characters of this value. 

Transaction Replay Attacks 
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The processing of Internet-based payment transactions is a coordinated 
interaction between the Internet Transaction Gateway and the VPOS servers 
that is based on the following principles. A VPOS terminal, as the initiator 
of the payment transaction, is responsible for the round-trip logical closure 

5 of the transaction. VPOS will retry a transaction that has been initiated with 
the Gateway but where the response for the request was never received from 
the Gateway. A VPOS terminal selects — out of a pre-assigned range — 
^Terminated that is to be used by the Gateway in a request to the host 
processor. This data element must be transported from the VPOS to the 

10 Gateway along with the payment-related information. The Terminal-Ids 
must be unique among the concurrent VPOS instances on a VPOS server 
system. However, the Terminal-Ids have no history. For example, a 
subsequent Force Post transaction need not use the same Terminal-Id as 
the original Authorization transaction. The VPOS will be responsible for 

1 5 making sure that only one request is outstanding for the same <Merchant- 
id, Terminal-id> data elements from a VPOS server system. The Gateway 
does not know that a response was successfully received by VPOS. This 
means that the VPOS must be responsible for initiating any retry attempts. 
The Gateway never initiates a retry attempt with the host processor without 

20 an explicit retry request from VPOS. The Gateway when asked to retry a 
request with the host, performs a relational database look-up and delivers a 
response that has already been received from the host processor but was 
previously missed by VPOS. This behavior of the Gateway is also known as 
the "transaction response cache." The Gateway will need to know that a 

25 VPOS request is a retry of something already sent. The prior request may or 
may not have been received. A solution for determining the difference 
between a retry attempt and a new request is described later in this 

_ _ document. VPOS must understand the^canonical'Lerrar codes that it will 
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receive via the Gateway and be able to initiate the proper recovery action 
and/ or generate the appropriate user-interface dialog. 

Certificate Processing 

5 Merchants require a mechanism for verifying legitimate cardholders is of 
valid, branded bankcard account numbers. A preferred embodiment utilizes 
technology to link a cardholder to a specific bankcard account number and 
reduce the incidence of fraud and thereby the overall cost of payment 
processing. Processing includes a mechanism that allows cardholder 
10 confirmation that a merchant has a relationship with a financial institution 
allowing it to accept bankcard payments. Cardholders must also be 
provided with a way to identify merchants they can securely conduct 
electronic commerce. Merchant authentication is ensured by the use of 
digital signatures and merchant certificates. 

15 

In a preferred embodiment, a holder of a payment instrument (cardholder) 
surfs the web (internet) for required items. This is typically accomplished by 
using a browser to view on-line catalog information on the merchant's World 
Wide Web page. However, order numbers can be selected from paper 

20 catalogs or a CD-ROM and entered manually into the system. This method 
allows a cardholder to select the items to be purchased either automatically 
or manually. Then, the cardholder is presented with an order form 
containing the list of items, their prices, and totals. The totals could include 
shipping, handling and taxes for example. The order form is delivered 

25 electronically from the merchant's server or created on the cardholder's 
computer by electronic shopping software. An alternative embodiment 
supports a negotiation for goods by presenting frequent shopper 

— identification and information about a~competitor's prices. 

16\ 
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Once the price of goods sold and the means of payment has been selected, 
the merchant submits a completed order and the means for payment. The 
order and payment instructions are digitally signed by cardholders who 
possess certificates. The merchant then requests payment authorization 
5 from the cardholder's financial institution. Then, the merchant sends 
confirmation of the order, and eventually ships the goods or performs the 
requested services from the order. The merchant also requests payment 
from the cardholder's financial institution. 

10 Figure 1C is a block diagram of a payment processing system in accordance 
with a, preferred embodiment. The Certificate Issuance at the Bank Web Site 
162 resides at the bank web site 182. It is utilized for issuing SET complaint 
/ X.500 certificates to consumers. The implementation of this system may 
vary from one bank to another. However, the system gathers consumer's 

15 personal information, and after processing the information, the system 
issues a certificate along with a payment instrument to the consumer. 

The Single Account Wallet 160 at the bank web site 182 represents the 
MIME message that is created by the Certificate Issuance system. This MIME 

20 message contains a VeriFone wallet. The VeriFone wallet contains a single 
payment instrument and the certificate associated with it. For security 
reasons, the private key is not included in the wallet. The has to specify a 
private key before using the instrument for payment. When the consumer is 
issued the certificate, this MIME message is sent to the browser. The 

25 browser launches the Certificate Installation application 174, 144 which is 
defined as a helper application in the browser. The Certificate Installation 
application 174, 144 reads the MIME message and install the wallet into the 
wallet database-158 — 
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Various helper applications 198, 172, 174, 176 are provided to make the 
consumer's shopping experience easy and efficient including the following 
helper applications. The Paywindow helper application 188 is utilized by the 
consumer to authorize the payment to the merchant, to administer their 
5 wallets, to review their previously completed payment transactions and to 
perform housekeeping activities on the wallets. This application is defined as 
a 'helper* application on the consumer's desktop. The browser launches this 
application when the merchant system sends a MIME message requesting 
payment. 

10 

The PayWindow Setup Helper application 172 is used by the consumer to 
install helper applications and other modules from the web site onto the 
consumer desktop. When a consumer attempts to install an application for 
a first time, the consumer does not have a helper application on the 

15 desktop. Thus, the first time installation of an application requires a 

consumer to perform two steps. First the user must download the system 
package to their desktop and then the user must run setup to decompress 
and install the system. Thereafter, whenever the consumer gets a new 
release of system software, the browser launches this helper application 

20 which in turn installs the appropriate other system modules. 

The Certificate Installation Helper Application 174 is utilized to install a 
wallet that is issued by a bank. When the bank's certificate issuance web 
system sends the MIME message containing the VeriFone wallet, the 
25 browser launches this application. This application queries a consumer to 
determine if the payment instrument contained in the wallet is to be copied 
to an existing wallet or to be kept in the new wallet. This application then 
... installs the. payment instrument and thejc.ertificatej^ database 
158. 



to 
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The Certificate Issuance CGI scripts 162 and the Single Account Wallet 160 
at the Bank Web Site 182 is processed as described in the native system. 
The Certificate Installation Applet of the Bank Web Site 182 is utilized by 
5 the Certificate Issuance CGI scripts 162 system to deliver a consumer's 
certificate to the consumer's desktop. 

Figure 26 is an architecture block diagram in accordance with a preferred 
embodiment of the subject invention. Processing commences at function 

10 block 2600 where the Graphical User Interface (GUI) part of the application 
is initialized. The GUI application 2600 provides the consumer with support 
for ordering and making payments during the shopping process. There are 
also GUI components provided for wallet creation; importing, certificate and 
payment method creation and maintenance; and for transaction register 

15 review and reporting. The screen designs, and their associated logic, for the 
helper applications and applets are individually discussed in detail below. 

The Certificate Manager 2604 manages the automatic downloading of a 
consumer's certificate from a bank, validation of a consumer's and a 
20 merchant's certificates and automatic requisition of certificate renewal. 

The Payment Manager 2606 coordinates and completes the payment request 
that is received from the merchant system. The payment request is received 
via a MIME message in the native code implementation or via an applet in 

25 the Java implementation. The payment request received contains the final 
GSO, Ship-To name, merchant certificate, merchant URL, coupons and the 
payment amount. The manager 2606 then communicates with the payment 

related GUI component to interact wit h the consumer to authorize and 

complete the payment transaction. The manager is also responsible for 



WO 98/37675 



PCT/US98/03236 



determining the payment protocol based on the consumer's payment 
instrument and the merchant's preferred payment protocol. 

The manager 2606 includes a well defined Application Programming 
5 Interface (API) which enables OEMs to interface with the payment manager 
2606 to make payments to specific HTTP sites. The detailed logic associated 
with the payment manager 2606 is presented in Figure 27. 

The payment manager 2606 enforces standard operations in the payment 
10 process. For example the receipt and the transaction record can 
automatically be transferred to the Wallet file once the payment is 
completed. The payment manager architecture in accordance with a 
preferred embodiment is presented in Figure 27. A user interfaces with the 
payment manager 2730 via a user interface 2700 that responds to and 
15 sends a variety of transactions 2710, 2708, 2706, 2704 and 2702. The 
transactions include obtaining the next record, payment record, receipt, 
acceptance of the payment instrument and GSO components. In turn, the 
payment manager 2730 sends transactions 2714 and receipts 2720 to the 
wallet manager 2722 and receives payment instruments, certificates and 
20 private keys from the wallet manager 2722. 

The payment manager 2730 also sends and receives transactions to the 
protocol manager 2770 including a merchant's payment message 2760, a 
consumer certificate and PK handle 2750, a merchant URL 2742, a 
25 payment 2740, a signed receipt 2734 and a GSO, Selected Payment 

Protocol and Selected Payment Instrument 2732. The payment manager 
2730 also accepts input from the payment applet or MIME message from 
the merchant as show n at fu nct ion block 2780. One aspect of the payment 
processing is a Consumer Payments Class Library (CPCL) 2770 which 
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encapsulates the payment protocols into a single API. By encapsulating the 
payment protocols, applications are insulated from protocol variations. A 
SET Protocol provides an implementation of the client-side component of the 
Secure Electronic Transaction (SET) Protocol. A complete implementation of 
5 the client-side component of the CyberCash micro-payment protocol is also 
provided. 

The Wallet Manager 2722 provides a standard interface to the wallet. It 
defines the wallet database structures and the payment instrument data 
structures, controls the access to the wallet and provides concurrency 

10 checking if more than one application attempts to open the same wallet. 
The interface to the wallet manager 2722 is published to allow OEMs to 
interface with the wallet manager and access the wallet database. 
The wallet manager consists of the following sub-components: 
Wallet Access. This component provides an interface to read and write 

15 wallet information. 

Transaction Manager. This component provides an interface to read and 
write transaction corresponding to a wallet into the wallet database. 
Payment Instrument Manager. This component manager provides a 
common interface to the specific payment instrument access components. 

20 Credit Card Access, Debit Card Access, Check Access. These components 
deal with a specific payment instrument. 

A Data Manager provides storage and retrieval of generic data items and 
database records. It is assumed that data fields, index fields or entire data 

25 records can be marked as encrypted and the encryption process is largely 
automated. The data manager has no specific knowledge of database 
records appropriate to different payment methods. This layer is separated 

out so as to reduce changes required-when-new -payment methods are - 

introduced. However RSA key pairs and certificates might be considered as 

>0U 
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"simple" data types. This component also provides an abstraction which 
supports wallet files on computer disk or contained in smart cards. 

The Open Data Base Connectivity (ODBC) /Java Data Base Connectivity 
5 (JDBC) component provides Data Base Connectivity where formal database 
components are required. An embodiment of the Smart Card Wallet allows 
wallet data to be stored and/or secured by a cryptographic token. 

A preferred embodiment includes a single file or directory of files comprising 
a "wallet" which contains personal information and information about 
multiple payment methods with the preferred implementation. These 
payment methods ( Visa cards, debit cards, smart cards, micro-payments 
etc. ) also contain information such as account numbers, certificates, key 
pairs, expiration dates etc. The wallet is envisaged to also contain all the 
receipts and transaction records pertaining to every payment made using 
the wallet. A Cryptographic API component provides a standard interface for 
RSA and related cryptographic software or hardware. This support includes 
encryption, signature, and key generation. Choice of key exchange 
algorithm, symmetric encryption algorithm, and signature algorithm should 
all be configurable. A base class stipulates generic behavior, derived classes 
handle various semantic options (e.g. software based cryptography versus 
hardware based cryptography.) 

The Cryptographic Software portion provides RSA and DES support. This 
25 may be provided utilizing the SUN, RSA or Microsoft system components 
depending on the implementation selected for a particular customer. 
Cryptographic Hardware creates a lower level API which can underpin the 
__ - Cryptography API and be utilized to replace Cryptography Software with an 
off the shelf cryptography engine. 

>*1 
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The message sequence charts describe the flow of messages/ data between 
the consumer, the browser and/or the various major components of the 
Semeru system. The major components of the system are the Merchant 
system which includes the vPOS, the PayWindow, and the Payment 
5 Gateway. The merchant system allows a consumer to shop, accept the 
payment transactions sent by the PayWindow application, and send 
payment transactions to the acquiring bank. The Consumer Payments 
Class Library (CPCL) module is a layer within the application which sends 
the payment transactions, securely, from the consumer to the merchant. 

10 

Figure 28 is a Consumer Payment Message Sequence Diagram in 
accordance with a preferred embodiment of the invention. The diagram 
presents the flow of messages between the consumer, the browser, the 
merchant system, the PayWindow application, and CPCL. This message flow 

1 5 describes the payment process from the time an order is completed and the 
consumer elects to pay, to the time the payment is approved and the receipt 
is returned to the consumer. The difference between the Native 
implementation and Java implementation of the PayWindow application is in 
the delivery of the order information to the PayWindow. Once the order 

20 information is received by the PayWindow, the flow of messages/ data is the 
same for both implementations. In the case of the Native implementation, 
the order information is delivered via a MIME message. This MIME message 
is sent to the PayWindow by the browser via a document file. In the Java 
implementation, the order information is delivered to the PayWindow by an 

25 applet. The merchant system sends an applet with the order information to 
the browser which in turn delivers the order to the PayWindow. Once the 
order is received, the PayWindow interacts with the consumer and the 
Protocol, modules_for _the ..completion of the payment process.. 



WO 98/37675 



PCT/US98/03236 



Enters Order and Clicks Calculate Order 2820 

This message represent the consumer order entry and the clicking of the 
'Calculate Order' button. The consumer's shopping experience is all 
condensed into this one message flow for the purpose of highlighting the 
5 payment process. The actual implementation of the shopping process 
varies, however, the purpose does not, which is the creation of the order. 
Order 2830 

This message represents the order information which is sent by the browser 
to the merchant via an HTML form. 

10 

Payment Applet with GSO, PPPs, Ms, merchant certificate and URL 2840 
On receipt of the order, the merchant system calculates the payment 
amount. This message represents the HTML page which is sent by the 
merchant system detailing the payment amount along with the Java 
15 payment applet which contains the GSO, PPPs, AIs, merchant certificate and 
URL. 

Run Payment Applet 2845 

The Java enabled browser runs the Payment applet. The applet displays a 
20 button called "Pay* for the consumer to click. This is embedded in the 
HTML page delivered by the merchant. 

Clicks Pay 2850 

This message represents the clicking of the Pay button on the browser by 
25 the consumer after confirming the payment amount. 

GSO, PPPs, AIs. merchant certificate and URL 2860 



>°1 
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This message represents the GSO, PPPs, AIs, merchant certificate and the 
merchant URL carried by the Java applet. The Java applet now delivers 
these to the PayWindow application. 

5 Merchant certificate 2862 

This message represents the merchant's certificate which is sent to the 
CPCL module for checking the validity of the merchant. 

Merchant's validity 2864 
10 The CPCL modules examines the merchant's certificate and send this 

message to the PayWindow indicating whether or not the merchant is a valid 
merchant. 

Wallet, Payment Instruments 2866 
15 This message represents the wallets and payment instruments that is 
displayed to the consumer. Not all payment instruments from a wallet is 
shown to the consumer. Only the ones accepted by the merchant is shown. 

Payment Instrument 2868 
20 This message represents the payment instrument selected by the consumer. 
This message is created in the current design when the user double clicks 
on the payment image in the "Select Payment Method" Window. 

GSO 2870 

25 This indicates that the GSO is displayed to the consumer in the "Make 
Payment Authorization" screen. 

Authorization, .of. Payment 2872 . 

Mo 
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This message represents the authorization of the payment by the consumer. 
The consumer authorizes the payment by clicking the 'Accept' button on the 
"Payment Authorization" screen. 

5 Decide Payment Protocol 2874 

Once the consumer authorizes the payment, the payment protocol is decided 
by PayWindow based on the merchant's Payment Protocol Preferences and 
the consumer selected payment instrument. 

10 Payment Authorization 2875 

These messages represent the merchant's URL, the GSO, payment protocol 
(PP) to use, account number, certificate and the private key handle (PK) 
associated with the payment instrument which is sent to the protocol 
module. 

15 

GSO with Payment Authorization 2876 

This message represents the payment instructions which is sent by the 
protocol module to the Merchant system. The GSO, PI, consumer certificate 
and PK is packaged based on the payment protocol. 

20 

Signed Receipt 2878 

This message represents the digitally signed transaction receipt received by 
the protocol module from the merchant. . 

25 Save Receipt with hash value 2880 

The digitally signed transaction receipt is saved by the PayWindow for future 
reference. 

Payment Successful 2882 
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This indicates that the transaction receipt and the 'payment successful' have 
been displayed to the consumer. 

Certificate Processing 

5 A payment instrument must be certified by a "certificate issuing authority" 
before it can be used on a computer network. In the case of credit card 
payments, the issuer may be one of the card issuing banks, but it might also 
be a merchant (eg SEARS), a transaction aquiring bank or an association 
such as VISA or Mastercard. 

10 

Payment instrument information is stored in the consumer's wallet. The 
certificate which authorizes the payment instrument will be stored along 
with that data in a secured database. The process of acquiring a certificate 
is described below. A certificate can be delivered to a consumer in a 
15 preconfigured wallet. The consumer receives a wallet which contains the 
certificate together with the necessary details associated with a payment 
instrument including a payment instrument bitmap which is authorized by 
a certificate issuing authority or the agencies represented by the issuing 
authority. 

20 

Obtaining a certificate 

A consumer will deliver or cause to be delivered information to a certificate 
issuing authority. Figure 29 is an illustration of a certificate issuance form 
in accordance with a preferred embodiment. A user may fill out the form 

25 on-line, on paper and mail it in, or get his bank or credit card company to 
deliver it. The consumer delivered data will usually contain a public key 
belonging to a security key pair generated by consumer software. This 

information will normally be mailed to_the consumer!s_address_and actuated 

by a telephone call from the consumer. The certificate authority takes this 
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information and uses it to validate that he is indeed entitled to use the 
payment method. This processing normally takes a few days to accomplish. 
Information will normally be exchanged with the organization issuing the 
payment method-in the physical space if there is one, and with credit 
5 agencies. The certificate information is loaded into the consumer's software 
to enable payment processing to proceed online. 

In some cases the consumer will be able to select details about a payment 
instument holder (wallet) he desires to own. This may be the icon 
representing a holder, the access password or other information. After 
creating the certificate, the issuing authority can use information received in 
the certificate application to create a custom payment instrument holder 
ready to use. This payment instrument holder will contain the following 
information. Payment instrument information including card number 2900 
and expiration date 2902. Personal information including name 2904, 
address 2906, social security number 2908 and date of birth 2910. 

The associated certificate ( egX509 standard ), an associated public key or 
in some cases public/ private key pair ( eg RSA), and an approved bitmap 
20 representing the payment instrument are provided to the requesting 
consumer. Figure 30 illustrates a certificate issuance response in 
accordance with a preferred embodiment. An approved bitmap for a VISA 
card is shown at 3000. Also a default payment holder 3010 and a default 
payment holder name are provided with the certificate issuance. After the 
25 consumer aquires the payment instrument holder 3010, the payment 

instrument holder is immediately visible to him in his collection of payment 
instrument holders. Figure 31 illustrates a collection of payment 

instrument holders Jn.accordajnciSL with a preferred embodiments _The 

predefined payment instrument holder 3100 is the same JOHN'S WALLET 



10 



15 



WO 98/37675 PCT/US98/03236 

that was predefined based on defaults by the certificate issuance form. 
Figure 32 illustrates the default payment instrument bitmap 3200 
associated with the predefined payment instrument holder 3210 resulting 
from the consumer filling in and obtaining approval for a VISA card. 

5 

Figure 33 illustrates a selected payment instrument with a fill in the blanks 
for the cardholder in accordance with a preferred embodiment. Next time 
the payment instrument holder is opened in a payment context the 
certificate issuing authorty's approved instrument bitmap can be used to 
10 select the payment instrument and utilize it to make purchases. Figure 34 
illustrates a coffee purchase utilizing the newly defined VISA card in 
accordance with a preferred embodiment of the invention. 

Figure 35 is a flowchart of conditional authorization of payment in 
15 accordance with a preferred embodiment. Processing commences at 3500 
where the program initializes the connection between the cardholder and the 
merchant using SET or SSL for encrypted communication. Then, at function 
block 3510, the cardholder selects the payment instrument for the 
particular transaction. Payment instruments could include VISA, 
20 MASTERCARD, AMERICAN EXPRESS, CHECK, SMARTCARD or DEBIT 
CARDS. The payment method is then submitted to the merchant at 
function block 3520. The merchant then initializes the SET connection to 
the acquiring bank at function block 3530 if the connection is not already 
established. Then, at function block 3540, the certificate is submitted to 
25 the merchant from the acquiring bank. The certificate includes a public key 
portion and a private key used as an irrebu table digital signature to 
authenticate the parties to the transaction. The certificate also includes 

information_on„the_le_v_eLot_credit risk which allows a_merchaiitjto_ 

conditionally decide on the authorization or rejection of credit under a 
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particular payment instrument based on their risk level and the merchant's 
personal comfort level with the ability of the cardholder to pay. This 
processing has not previously been possible because the information 
returned from the authorizing bank did not include a level of credit risk a 
5 cardholder posed, it only contained credit rejected or approved. 

Figures 36-48 are screen displays in accordance with a preferred 
embodiment. 

10 CMI process 

This note describes VFI's process for creating key-pairs and obtaining the 
certificates which bind the identity of the 

key-holder to the public component of those key pairs. The same process is 
used both for vPOS and vGATE. Thus, the discussion focuses only on the 
15 case of vPOS (i.e. the merchant) and the Certification Authority (CA). 

Public key cryptography is the study and practice of encryption, decryption 
and authentication of messages using two forms of keys: public keys (also 
known as "public components of a key pairs") and private keys (also known 

20 as "private components of key pairs".) Public key cryptography employs 
mathematical abstractions called "key pairs" which have two halves: the 
public component and the private component. These two corresponding 
halves induce mathematical transformations which are mutual inverses of 
each other. This allows an agent to transform a message using the public 

25 component and later reverse that transformation using the private 

component, or vice-versa. Transformation (via the induced function) using 
the public component is an effective means of encryption. Reversing this 
___transfQmiationjU5ing the private component decry pts the m essage. . 
Transformation using the public component is an effective means of digital 
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signature. Reversing this transformation using the public component 
decrypts the message and thus verifies the signature. 

If two agents on an open network are required to transmit messages .back 

5 and forth to each other using public-key cryptography, then both agents will 
likely need their own key pair. Lets take two agents "Alice" and "Bob", with 
their own key pairs <A_pub, Ajpriv> and <B_pub, B_priv>. Both Alice and 
Bob keep their own respective private components to themselves as a secret 
that no one else can know. Additionally, Alice and Bob publish (on the open 

10 network) their public components so that everyone can have access to them. 
Now when Alice wishes to correspond with Bob, she takes the public 
component of Bob and encrypts her message using B_pub. She sends this 
encrypted message to Bob who, after receiving it, decrypts the message 
using his private component B_priv. If Bob would like to sign a message M 

15 so that Alice knows that it is from him, Bob would encrypt M using B_priv 
and then send M together with the encrypted version of M to Alice. Alice 
would then apply B_pub to the encrypted version and compare it to the 
original message sent by Bob. If Alice finds that these two messages (the 
original M and the decrypted M) match, then she can conclude that only Bob 

20 could have sent the message. 

The entire preceding discussion makes one crucial assumption: Alice knows 
that B_pub is in fact the public component which belongs to Bob (and vice 
versa.) If Alice mistakenly uses a public component which belongs not to 
25 Bob, but some malicious third party; then Alice's messages to Bob can be 
intercepted and read by that malefactor. Digital certificates are used in 
order to guarantee that agents use the correct public component. 
Certificates are digitally signed messages which attest to the ownership of a _ 
public component. Minimally, a certificate is a 
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signed message which includes the name of the owner of the key-pair, and a 
copy of the public component. These message are signed by a trusted third 
party known as a Certification Authority. The process of obtaining such 
certificates for vPOS and vGATE is key to the CMI process. 

5 

Overview of the CMI process 

Five steps are used in VFI's CMI process. They are: 

1) Creation of key pairs 
10 2) Storage of private components 

3) Secure upload of public component 

4) Registration 

5) Retrieval 

15 All steps are performed using a browser operating in one of two modes: 1) 
interacting locally with a vPOS web server, or 2) remotely over the open 
Internet using SSL. The key aspects are that the creation, storage, and 
certification of key pairs is done on one host under administrative control 
from another host (via a browser.) This is important since it facilitates the 

20 utilization of a public-key management scheme for vPOS which can be 
controlled by a browser either at the console of the machine (via local 
interactions with the web server) or remotely (via remote 
interactions with the web server.) 

25 Details of the CMI process 

Creation of key pairs 

A user is directed to a URL on vPOS which starts a CGI program which 

creates a key-pair. This proces s mus t accumulate sufficient amounts of 

entropy so that the key-pair is ensured to be unique. 
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Storag of private components 

The vPOS unit then saves the private component of the key pair to disk in a 
secure fashion. The vPOS administrator is prompted for a password which 
5 is used to secure the storage of the private component. 

Secure upload of the public component 

The public component of the key pair is then delivered back to the vPOS 
administrator (who represents the agency being certified) embedded 
10 transparently in a hyperlink in the web page which serves as a response to 
the key-creation request. The hyperlink is created in such a way so that 
when the administrator clicks on it, the browser 
establishes an SSL link with the Certification Authority and uses it to 
upload the public component of the key pair. 

15 

Registration 

Once the Certification Authority receives the public-component of the key- 
pair, it responds to the administrator (via the browser) with an HTML form 
which prompts for identifying information. This information will be used to 
20 establish the true identity of the requester and thus determine his eligibility 
for certification. After the administrator has completely filled in the form, 
the Certification Authority has all information necessary to issue a 
certificate. If at 

some later point, the CA decides to issue a certificate; it may notify the 
25 administrator via email or even real-time. 

Download 
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If the CA issues a certificate to the administrator, the vPOS administrator 
can simply download the certificate off the web site via ftp, email, or the 
Web. 



5 DETAILS OF THE CERTIFICATION PROCESS 

Application for an account 

Before the merchant receives vPOS software, the business must first 
establish an account with the bank. Even if the merchant has an account 

10 with the bank which allows them to process credit card transactions at the 
physical point-of-sale, an application for an "Internet Merchant" account 
must be sent to the bank. The bank has policies which determine what kind 
of paperwork is required in order to establish an account. Minimally, the 
paperwork must include some means by which the bank can establish the 

15 legal identity of the merchant and /or the corporation that the merchant will 
be running. The bank will also be asking for a variety of documents to 
demonstrate both credit-worthiness and the viability of the business. 

The merchant sends the application to the bank via US Mail. The bank then 
20 begins its evaluation of the application. If the bank approves the 
application, the merchant will receive two items via US Mail: 

1) A vPOS software module (together with manuals) 

2) An approval letter which contains two crucial parameters: 
25 a) The Merchant ID number (known as the MID) 

b) A shared secret generated by the bank which will be used as 
proof to the bank that this merchant has been approved. 
The pxecisejform of this_secret will vary from bank to bank. 
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The two parameters delivered in the letter are generated by the bank. The 
shared secret should not be shared with anyone except for the merchant, 
the bank, and the certification authority. If it somehow escapes, the 
security of the scheme is undermined. 

5 

2.0 Overall UI Flow 

In this context, the term "administrator* refers to the person operating 
the vPOS or vGATE installation. This individual must have direct access to 
the console of the host in question and must necessarily be a trustworthy 
10 party. 



The UI flow for certificate management begins on he "Certificate 
Management" page. This page will be referenced by the main administrative 
15 page of vPOS and vGATE. It will contain a sequence of links which will lead 
the administrator through all steps necessary to create key-pairs, deliver 
certificate requests, accept signed certificates, and install them into the 
database. 

20 The steps the administrator must follow are: 
-Create an administrator's password 

-Generate an encryption key-pair and submit a corresponding CSR 
-Generate a signature key-pair and submit a corresponding CSR 
-Pickup a signed encryption certificate 
25 -Pickup a signed signature certificate 

-Load the encryption certificate into the certificate database 
-Load the signature certificate into the certificate database 



^0 
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Once these steps, which are detailed below, have completed then the vPOS 
and vGATE is available to process transactions. 

Password Creation 

5 This page asks the user to create a password. The page should spell out 
specific guidelines as to what sort of passwords are secure, and which are 
not. There will also be an HTML form which will prompt the administrator 
for a password, and a retype of the password. Two important side-effects 
will result from the successful creation of a password: 
10 i) A backup of the password will be created on a floppy disk. 

2) A checksum file will be created allowing further uses of this 

password to be verified against the checksum before the password 
is used for encryption /decryption. 

15 The presence of a checksum file will also allow the software to understand 
that it has already created a password (and a backup file for this password.) 
This one password will be used for secure access to all sensitive data in the 
vPOS system. It will be used to store PANs in the database, and private 
components of key-pairs. 

20 

Creation of a Key Pair 

Once the vPOS/vGATE software is installed and the administrator has 
access to the Internet via an SSL capable browser, then both vPOS and 
vGATE have administrative interfaces which are rendered via CGI programs 

25 accessed locally on the server. This same UI paradigm will be used for key- 
management functionality. The administration pages for vPOS and vGATE 
will both contain links to a "Create Key Pair* page that will begin the 

certification process. Clicking on this link initiates, an JiTML form which lets 

the user know that they are about to create a key pair. The form prompts 
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for the password that was already created in a previous phase. Once the 
administrator hits the SUBMIT button on the web page, a CGI program is 
invoked which begins to cut an RSA key pair. Here is what the CGI program 
does: 

1) Checks to see if the password matches its checksum via the 
SecStorMgr interface. Reject the password with an appropriate 
message if it does not match. 

2) Reserves enough system memory so that we can create a key pair of 
the appropriate length (usually 1024 bits.) This may be derived from a 
variety of system phenomena, including mouse movement. 

3) Creates an RSA key pair 

4) Stores the private component on a disk using password-based 
encryption (with the password that the user just typed in.) The 
encryption will also be performed by the SecStorMgr interface. 

5) Creates a PKCS-10 formatted CSR. Do not include any attributes 
in the PKCS-10 message at all. The PKCS-10 format demands that 
you sign the public component using the private component. 

6) Routes the CGI program output (via stdout) to the next page for the 
user to interact with. This page will contain some user-friendly text, 
like: "Success — You have generated a key pair!!". It will also contain 
a hyper link to the CA which has (as a URL parameter) the PCKS-10 
formatted, base64 e ncoded signed public key. The link will be of the 
format: 
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https: / /www.CA.com/cgi/certify_prog?- 
setpkcs 10= M 0df87jd4jd3296aaa. . . . 

5 By clicking on the link, the administrator transfers control over to the CA, 
while at the same time uploads the public component to the CGI program. 
At this point, the administrator should see a web page asking him or her to 
enter in a number of parameters that will go into the certificate. The page 
the CA displays should be an HTML form (the content of which is a 
10 negotiated by the bank and the CA.) Filling this form in brings us to the 
next step. 

Submitting a Certificate Signing Request 

After filling out the form completely, the administrator presses the SUBMIT 
15 button which uploads the form data to the CA. If any of the form 

components are ill-formatted, or if the signed public key does not verify 
correctly, the requests are rejected. Among the data components that will 
be prompted for (outside of those required by the SET specification) is the 
aforementioned shared secret. This secret (known only to the bank, the 
20 merchant, and the certification authority) is transmitted to the Certification 
Authority so that the bank has some means to identify valid certificate 
signing requests. Then, the administrator presses the SUBMIT button and 
receives confirmation of the receipt of valid parameters for a certificate, 
together with a reference number for this CSR. Now the administrator must 
25 wait until the bank and the Certification Authority informs him/her via 
email that the certificate is ready for retrieval. 

CA/RA proc essin g of a Certificate Signing Request 
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At this point, the CA (i.e. the Certification Authority) has all the information 
necessary to format and sign a certificate. The bank is the ultimate 
authority as to which certificates are to be signed. In "Certificate-lingo" the 
bank's role is called the RA (i.e. the Registration Authority.) Clearly the CA 
5 and the RA must exchange information in order to allow the bank to select 
the certificate signing requests that it believes are valid. This exchange is 
done by procedures negotiated by the CA and the RA. One example of an 
RA-style solution allows the bank to access the CA via an SSL-based web 
browser using hardware cryptography. There are other ways to achieve this 
10 same functionality, but in the end this a process which VFI need not 

address directly. These issues are among the topics that the CA and the 
bank will have to negotiate. The overall idea is that the bank (by some 
means) determines which CSRs are legitimate and communicates this 
information to the CA who signs only those requests. 

15 

If the CA receives consent from the bank to issue a certificate, then the CA 
formats a certificate and signs it using the bank's private-label key. The CA 
then places the certificate out on its Web server so that it is available for 
download. Finally, it emails a notice to the administrator that the certificate 
20 is ready. This step of the process may take a few days to complete, 

depending upon the frequency that the RA checks the CA and the amount of 
time required by the CA to sign and post the certificate. 

25 Receiving a Signed Certificate 

The email sent from the Certification Authority to the administrator contains 
a reference number that will allow the administrator to retrieve the 

certificate ._The email will also include an URL which p oint s to the web site 

where the certificate has been posted. The administrator will then direct 
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his/her browser towards the URL contained in the email. A URL to the 
"pickup site" will also appear on the "Certificate Management" page in vPOS 
and vGATE. The "pickup site" page (hosted by the CA) will prompt for the 
reference numbeF. Once the appropriate reference number has been 
5 entered, the administrator will see a page which contains hyperlinks which 
point to the certificates themselves. Clicking on these hyperlinks will 
prompt the server to download the certificate wrapped in a specified MIME 
type (application/x-set-cert.) The administrator can then save this 
certificate to disk in a filename of his/her choice. 

10 

The final act in the digital certification process is to have the administrator 
copy the certificate that has been saved to disk into the certificate database. 
This is done by specifying the location of the certificate file via a page found 
off of the vPOS/vGATE administration page. The software which reads this 

15 file will first verify that the certificate parses and is a valid digitally signed 
certificate before placing it in the database. The administrator will be able to 
see a decoded version of the certificate on the screen (presented in HTML) 
before he/she hits the SUBMIT button that sends the binary version to the 
database. The administrator will be doing both of these actions (obtaining 

20 and installing) both the signature certificates and the encryption certificates. 
This entails four separate actions in addition to the paperwork, key pair 
creation, and CSR submission phases. 

HTTPS TRANSPORT SPECIFICATION 

25 SET has a collection of messages devoted to the transport of CSRs and 
freshly signed certificates. In this design we have opted for a different 
transport mechanism for such data. The primary objective here was to 
streamline implementation byxhoosing-a-wellrknown. transport mechanism — 
which is relatively simple from the standpoint of interoperability. A secure 
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version of Hyper-Text Transport Protocol (HTTP via SSL, aka HTTPS) is the 
means by which a CSR is uploaded. This scheme combined with the 
shared-secret mentioned above has met with approval from a wide range of 
customers and alliance partners. It is difficult to give a complete analysis of 
5 the relative security of this mechanism versus the mechanism specified in 
SET. As of this writing, no customer or alliance partner has raised any 
significant objection to the security or feasibility of this approach. 

Another advantage of HTTPS as a transport protocol is that it integrates 
10 seamlessly with our chosen UI idiom: HTML. An HTTPS upload can be 
rendered in HTML. The information necessary to begin the CSR process at 
the CA's site can be encapsulated in a few parameters to the POST 
operation. Two types of information must be conveyed to the CA in the 
HTTPS post which serves to begin the processing of a CSR: 1) the public 
15 component of the key pair, and 2) the type of certificate being requested. 
The public component of the key pair will be delivered in base 64 encoded 
PKCS-10 format. The certificate type will be encoded as a pre-agreed set of 
flags between VFI and the CA. 

20 The PKCS-10 format allows us to express several identifying parameters to 
the CA. The only component of the PKCS-10 format that we must fill out is 
the public component. Currently, no other fields are required; the 
information that is missing from these fields will be supplied in the 
aforementioned HTML form that the CA displays to the merchant. The 

25 PKCS-10 format demands that the public key is presented in a fashion that 
demonstrates that the sender has knowledge of the corresponding private 
component. Technically speaking, this means that the private component is 

signed-with the private component. _Tool-kits„exist_which perform these 

functions automatically. 
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A table is provided below of the acceptable POST name value pairs that will 
appear in our HTML. 



Name 


Format of Value 


Notes 


setpkcs 
10 


one contiguous line of double- 
quotes enclosed base 64 
encoded 

pkcs-10 formatted data 


CAs may request some format 
adjustments to the PKCS-10 
payload. None are known at 
this point. 


cert_typ 
e 


Valid values are "ms", "me*, 
"ps", and "pe". These mean 
(respectively) "Merchant 
Signature", "Merchant 
Encryption", "Payment- 
Gateway Signature", and 
"Payment-Gateway 
Encryption" 


Unsupported flag values "ma" 
and "pa" will eventually allow 
both "Encryption" and 
"Signature" CSRs to be 
created and uploaded 
simultaneously. 



5 

An example of the HTML code that can be used to deliver the PKCS-10 
message appears below.. This page illustrates the code which creates a key- 
pair and corresponding PKCS-10 message. 



10 <HTML> 
<HEAD> 

<TITLE> Certificate Request </TITLE> 
</HEAD> 

<form action - 'https:// www.CA.com/cgi-bin/cert_enroll.perl" method 

15 -='±post L '-> 

£V1 
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<input type -'hidden" name="-setpkcslO" value 

="MIIBizCB9QIBADBOMQswCQYDVQQGEwJVUzERMA8GA 1 UEChMIVmVya 
UZvbmUxHTAb 

BgNVBAsTFE 1 lcmNoYW50IENlcnRpZmljYXRlMQ0wCwYDVQQDEwR2UE9T 
MIGfMAOG 

CSqGSIb3DQEBAQUAA4GNADCBiQKBgQDVb9da5+PrOHffmxuScbZlzbMwl 
ipKR2rY 

GHsQtEUvb3z88XHpXX4U94N0XBJ+25AG22iDoXeIG/8ubcslSWFoFQtPr3p 
80Iij 

RvMcyeVCO7YlJx0jyzwP6645LiXOJ571moxEokTMQm4TEsYan3k76Elpg61m 
J4f/ 

Cw9qJ8J/OQIDAQABMA0GCSqGSIb3DQEBAgUAA4GBAF/IPT4jsQAqkxata6 
Gf3Uht 

LO9tqadQFw/NwT/mUXuS71Z+N6BtE/LZNLzCD3uzPE0ctJnAQt02yLtvSAqq 
HZ7f 

xD32SBkL3dbFKS9GeyeY+5z4bzvHeREf80qy8L3wV9JgrmmY9hc6QTfo8q8Z 
sjBg 

KNL34tXQyG6RPiBBIi0d"> 

<input type - 'hidden" name ="-cert_type" value ="ms"> 

[content omitted for sake of brevity] 

</form> 

PASSWORD-BASED SECURE STORAGE 

Password-based encryption is a cryptographic technique which allows us 

reasonably secure_storage.oLtwo_forms_of sensitive information : private- 

components of RSA key-pairs, and PANs. Although hardware cryptography 
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would be a more secure means to store this data, we have come to the 
conclusion that it is not cost effective at this point for us to deploy such 
measures at vPOS. We will be deploying hardware cryptography as soon as 
possible in the vGATE code stream. 

5 

PBE schemes work by using symmetric key algorithms. The key is derived 
from a password which is not stored on the machine. The password is 
transformed into the symmetric key via a secure hash function. One 
disadvantage of this scheme is that if the user looses the password, the 

10 encrypted data becomes completely unusable. This property of PBE 

obviously leads us to the requirement for a backup of the password in some 
secure fashion. Backup of the password at an FI will probably have to 
happen in a manner determined by bank policy. Backup of the password at 
vPOS will be achieved by writing it to a floppy disk which is then ejected and 

15 stored in a safe place. 



The PBE scheme will be used to store two classes of sensitive data (PANs 
and private-components of key pairs.) Since password management can be 
confusing (to the point of being insecure), we also have the implicit 

20 requirement that there must be one password that will work to decode all 
classes of sensitive data. In order to facilitate this password management 
requirement, this specification calls for a "checksum" file which allows the 
software to check successive password entries against the initial password 
in order to guarantee that one unique password is used across the entire 

25 system. 

The security of PBE rests largely on the quality of the password chosen. If 
an_administrator_chooses_a,password which can be.guessed_by_ an attacker, 
the encryption algorithm will not be very much use. In the hacker 



WO 98/37675 



PCT/US98/03236 



community, many programs exist which contain libraries of commonly used 
"weak* passwords. These programs help an attacker sort through these 
weak passwords. Clearly our interface should enforce high standards of 
password quality: Many banks will have such policies available for our use. 

5 

A C++ API presenting PBE functionality compliant with the requirements 
listed above is presented below. After the class level interface, 1 will run 
through a few use-cases to illustrate usage. 

10 //A secure storage management interface 

/ / This class manages a simple interface 

/ / to a PBE scheme which facilitates password 

/ / backup and persistent storage of a password 

15 // checksum scheme. The standard imagined use-case 

/ / is to first call a "create" method which establishes 
/ / the backup file and the checksum file. The user 
/ / can then close down his/her access to this class 
/ / and return later to first "open" the secure storage 

20 // and subsequently call "encrypt" and "decrypt". 

/ / Obviously the password backup file should be stored on some 
/ / highly secure medium (say a floppy that gets put in 
/ / a safe.) 

25 

^define CPCL_SECSTOR_SUCCESS 0 
#define CPCL_SECSTORE_DOESJNrOT_EXIST 1 

#define CPCL^SECSTOR = ERRJVLREADY_EXISTS 2 L 

#defme CPCL_SECSTOR„WRONG_PASSWORD 3 



WO 98/37675 



PCT/US98/03236 



#define CPCL_SECSTOR_ERR_READING_BKUP 4 
#define CPCL_SECSTOR_ERR_WRITING_BKUP 5 
#define CPCL_SECSTOR_ERR_READING_CHKSUM 6 
#define CPCL_SECSTOR_ERR_WRITING_CHKSUM 7 
#defme GPCL_SECSTOR_NOT_OPEN 8 
#define CPCL_SECSTOR_ENCRYPT_FAILED 9 
#define CPCL_SECSTORE_DECRYPT_FAILER 10 

#define CHECKSUM_TEST "Version 1 .0/ test" 

class CPCLSecStorageMgr 

{ 

//Password storage 
unsigned char *sz_password; 
public: 

//////////////////////// 
/ / standard ctors/dtor 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
CPCLSecStorageMgr() ; 

CPCLSecStorageMgr(const CPCLSecStorageMgr &x); 
virtual -CPCLSecStorageMgrQ; 



//////////////////////////////////// 
//Storage management primitives. These 
//are virtual so that if you need to 

/ /implement storage. semantics_differently, 

/ /you may do so. 
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//////////////////////////////////////////////////////////// 

/ /Create two files: a backup file and a checksum 
/ /file. I recommend that the checksum file be 
/ /the PBE of a fixed known test string CHECKSUM_TEST. 
/ /This means that you able to validate against 
/ /the checksum if and only if you know the password. 
//Return CPCL_SECSTOR_ERR_ALREADY_EXISTS if it exists, 
virtual int create(unsigned char *sz_StorMgrname, 
unsigned char *sz_new„pas sword, 
unsigned char *sz_backup_filename) = 0; 



/ /Destroy the checksum file. I recommend that you 
/ / first verify that the password matches with the 
//checksum, 
virtual int destroy(unsigned char *sz„StorMgrname, 

unsigned char *sz_new_password) = 0; 

//Check to see if the checksum file exists and matches 
// the password. If it does return CPCL_SECSTOR_SUCCESS. 
// else, return CPCL_SECSTORE_DOES_NOT_EXIST. 
virtual int exists(unsigned char *sz_StorMgrname, 

unsigned char *sz_new_password) = 0; 

/ /This is basically a "create" but you leave out the 

/-/part where you create a backup file 

virutal int restore(unsigned char *sz_StorMgrname, 
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unsigned char *sz_new_password, 
unsigned char *sz_backup_filename) = 0; 



5 / /Obtain access to an already "create"d checksum 

//file. Minimally, this must check for 
/ / the existance of the password checksum 
/ /file, and then check the password against the checksum. 
/ /We must also strcpy the password into "sz_password". 

10 / /One way to define this is just: 

// { 

/ / exists(unsigned char *sz_StorMgrname, password); 
// strcpy (sz_password, password); 
/ / return CPCL_SECSTOR_SUCCESS; 

15 // } 

virtual int open(unsigned char *sz_StorMgrname, password) = 0; 



/ / Key hygiene and datastore maintenance. 
/ / This must memset out the password to nulls 
20 / / Anything else is up to the implementor. 

virtual int close() = 0; 

//////////////////////////////////////////////////// 
/ /Once a StorageMgr has been created and opened, you can use 

25 //it to encrypt or decrypt with these methods. Both of these 

//methods should check to make sure that the sz_password field 

//is non-null. If it is null, that means you have not "opened 

/ / the StorageMgr._In JJiisxase, Jhe.mutines should return 

/ / CPCL_SECSTOR_NOT_OPEN. Contrary to what the name 
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/ / of the class suggests, there are no methods which 
/ /actually *store* the bulk-encrypted data. That is 
//up to you. 

/////////////A//////////////////////////////////////////////// 
5 ////////////// 
//INPUT 
//OUTPUT 

encrypt(unsigned char *sz_cleartext, unsigned char *sz_ciphertext); 

10 //INPUT 
//OUTPUT 

decrypt(unsigned char *sz_ciphertext, unsigned char *sz_cleartext); 

}; 

/ /End of class definition 

15 

This interface will be used at the time the user creates a password and at 
the time a software component requires storage or retrieval of sensitive data. 
In order to create a password, the program would prompt for the password 
(and for a re-type of the password.) After checking that the password was 
20 sufficiently strong and that the re-typed password matches the original, the 
program would then: 

//Create a SecStorMgr 

CPCLSecStorageMgr myMgr; 

25 

//call the create method 

myMgr xreate("LogicalStorageName J, ) sz_usertypedpassword, 
a a:\backup.txe); - — - 
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///////////////////////////////////////////////////////////// 

/ /This method creates the checksum file and saves the backup. 
/ /Presence of the checksum file is an indicator that a password 
/ /has already been created. 

iiiiiiiiiiiii/iiiiii/iniiu/ii/iiiiiiii/i//iniiiiii/muiii 

Later on, when the program needs to encrypt or decrypt the data, the 
program would prompt for the password and then: 
//Create a SecStorMgr 

CPCLSecStorageMgr myMgr; 

//invoke the open method 

///////////////////////////////////////////////////////////// 

//The password checksum file. If the password passes 
/ / the checksum criteria, then the class prepares itself for 
/ /encryption by copying the password into the private 
/ / class variable sz_password. 

////////////////////////////////////////////////////////////// 
myMgr.open("LogicalStorageName'\ szjusertypedpassword); 

/ / Now we can call encrypt/ decrypt 

myMgr. encrypt(sz_Secret, sz_EncryptedSecret) ; 



KEY MANAGEMENT 

There-are two-veiy- important security sensitive aspects_RSA_key-pairs_that 

the vPOS/vGATE must address: 1) key pair creation, and 2) secure storage 
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of the private component. Two possible interfaces exist for RSA key pair 
generation: 

-BCERT's GenerateRSAKeyPair (from RSA) 

-SMAPI's CPCLKeyPairGenOp (written here at VFI) 

5 

Either of these two interfaces will be sufficient for the first deployment since 
they invoke the same BSAFE interfaces. At some point a switch to the 
CPCLKeyPairGenOp will enable the removal of a dependency on BSAFE (we 
have a requirement to be CAPI capable as well as hardware-crypto enabled.) 

10 SMAPI was designed to abstract away from specific implementations of 

cryptographic interfaces, so we should move in the direction of SMAPI at our 
earliest convenience. Outside of the raw interfaces for key-pair generation, 
we must also worry about the random numbers supplied to the underlying 
routines. Much care must be taken in order to ensure that the byte streams 

15 supplied to key-generation routines are sufficiently "random''. Without 
sufficient care, key-pairs can be predicted by attackers who apply reverse 
engineering techniques to the software. It is possible to measure the 
entropy of various system phenomena in a fashion which allows us to 
supply lower bounds on the number of bits of randomness we can expect to 

20 accumulate per second. By adding conservative estimates from all 

measured phenomena, we can acquire an overall understanding of how 
much time we need in order to accumulate a given level of randomness. 
This analysis, or some similar technique must be applied to help ensure that 
our key generation software is secure. 

25 

The second security sensitive aspect of key pair management is the storage 
of the private component. Once the key-pair has been generated, the private 
component must be stored _on_disk.for_later_use. PBE schemes (covered 
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above) will be used to store this data. A single routine is required to store 
this data. It has the following declaration: 



int StorePrivateComponent( 
CPCLKey *privComp, 
unsigned char *sz_password, 

SecStorMgr) 

unsigned char *sz_SMname, 
unsigned char *sz_path); 



//Private Component to be stored 
/ /Password used to store (via the 

/ /Logical name of the SecStorMgr 

/ /File location in which to store the key 



The semantics assume the caller retains deletion responsibility for all 
parameters. A similar function will be used to restore this data: 



int FetchPrivateComponent( 
15 CPCLKey **privCompPtr, //Priv. Component to be fetched 

(creates memory!) 

unsigned char *sz_password, //Password used to retrieve (via the 
SecStorMgr) 

unsigned char *sz_SMname, //Logical name of the SecStorMgr 
20 unsigned char *sz_path); //File location from which to read the 

key 



The semantics here assume the caller retains deletion responsibility 
for the last three parameters, and receives the responsibility to delete the 
25 newly created CPCLKey which is pointed to by *privCompPtr when they are 
through using that key. Here is pseudo-code for FetchPrivateComponent: 

FetchPrivateC&mpja^ szJSMname, 

sz_path) 
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1) Create a CPCLSecStorMgr and call its "open" method with 
password "sz_password" and logical name a sz_SMname". 

2) Open the file referred to by a sz_path" and do an fgets on this 
file in order to extract the first CRLF- terminated line named. 
Convert this text into an integer, and assign it to a variable 
named "outputlen", 

3) Do another fgets on this file in order to extract the encrypted 
private component. Name this string "EncryptedPrivComp". 
Take a strlen on this string and assign the result to 
"inputted. 

4) Obtain string storage space for a string of length "outputlen". 
Name this string "ClearTextPrivComp". 

5) Call the "decrypt" method of the CPCLSecStorMgr as 
follows:mySecStorMgr->decrypt(EncryptedPrivComp, 
inputlen, CleaiTextPrivComp, outputlen); 

6) Create a new CPCLKey from CleaiTextPrivComp and 
outputlen. Assign a pointer to this new CPCLKey to 
*privCompPtr. 

7) Return. 

Although it is implicit in the discussion above, the file format for encrypted 
private components will resemble: 

<ascii representation of length of cleartext>CRLF 
< encrypted version of private component>CRLF 

Once we have a key pair, we must store the private component in the 
fashion described above and praduce_aPKCS- LGLmessage from the public 
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component. Example code for this operation can be found in the BCERT 
demo inside the a GenerateCertRequest ,, procedure. 

Files that-store private-components adopt the following conventions: 



5 



Type of Private Component 


r lie/ l aoie name 


Merchant encryption private 
component for a merchant 
named <name> 


<name>.epc 

epc =- Encryption Private 
Component 


Merchant signature private 
component for a merchant 
named <name> 


<name>.spc 

spc == Signature Private 
Component 


Gateway signature certificate 


gateway.epc 


Gateway signature certificate 


gateway, spc 



1 o CERTIFICATE DELIVERY AND INSTALLATION 

After the CA signs a certificate, an email message is sent to the requester 
informing them that their certificate is ready to be picked up. As described 
above, the administrator of the system will use their browser to download 
the certificate to the disk. The administrator will then use the certificate 
15 management interface to load the certificate into the certificate database. As 
mentioned above, the software will prompt for a filename (which is the 
location that the user downloaded the certificate to) and then displays a 
confirmation screen to the administrator before installing the certificate into 

the database. The confirmation screen should-display the contents of the 

20 certificate in human readable form together with some indication as to 
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whether the certificate passes the chain validation tests. This section 
describes the certificate database API that will be employed by the software 
that loads certificates. 

5 There has already been extensive discussion of a generic database API for 
certificate services. The API below presents functionality necessary to deploy 
vPOS and vGATE. Although many needs are left unaddressed by this API. 
Many basic business process issues have yet to settle down completely, 
leaving many of the market requirements for this API in flux. It would be 

10 unwise at this point to attempt complete coverage of every foreseeable need 
at this juncture given the uncertainty surrounding issues such as CRLs, 
certificate renewal, and thumbprint support. When we see demonstrable 
market need for such services, this API will have to evolve and adapt to 
those requirements. This API is defined as an abstract base class so that 

15 different implementations on vPOS and vGATE can go their separate ways. 

Note that this scheme does not require storage of multiple certificates per 
file/table. This aspect simplifies the implementation profile greatly since no 
DB schema is necessary. Again, it is my position that as demonstrable 
20 market need for more complete certificate services arise; we will be in a 

better position to understand storage and data-maintenance requirements. 
At that point we can re assess our requirements and re-implement on top of 
a true schema. 

25 class CertDataStore 
{ 

public: 

/./-SEMANTICS: 

// 1) Check to see that certificate passes chain-validation test 
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// 2) copy sz_filename to <fixedpath>/"szj:ablename'\enc 
virtual int InsertEncCert( 

unsigned char *sz__filename, 

unsigned char *sz_tablename) = 0; 

//SEMANTICS: 

// 1) Check to see that certificate passes chain -validation test 
// 2) copy szjilename to <fixedpath>/*szj:ablename , \enc 
virtual int InsertSigCert( 

unsigned char *szjllename, 

unsigned char *sz_tablename) = 0; 

/ /Except for administrative purposes this will never 
//be used by the gateway. This will be used quite often 
//by the vPOS in order to send the certificate to the gateway 
//so that it can encrypt data back to the merchant. 
/ /SEMANTICS: Read <fixedpath>/"sz_tablename w .enc and place in 

buf 

virtual int GetMyEncCert( 
unsigned char buf]], 
int buflen, 

unsigned char *sz_tablename) = 0; 

/ /Both vPOS and vGATE will make extensive use of this cert. 
/ /SEMANTICS: Read <fixedpath> /*szj:ablenanie'\sig and place in buf 
virtual int GetMySigCert( 

unsigned char buf[], 
: int-bufl.cn,. . 

unsigned char *sz„tablename) = 0; 
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/ /This seems quite unnatural, but the vPOS has to have 
/ / access to this certificate in order to encrypt material 
//to the_ gateway. The Gateway in fact does not need this 

function 

/ /since it can call GetMyEncCert The vPOS must have this 

function 

//since calling "GetMyEncCert" will fetch the encryption 

certificate 

//of the vPOS itself, not of the gateway. 
//SEMANTICS: 

// 1) Check to see that the certificate passes chain-validation test 
// 2) Read <fixedpath>/ gateway. enc and place in buf 
virtual int GetGatewayEncCert( 

unsigned char buff], 

int buflen) « 0; 

}; 



Files that store certificates (or sequences of certificates) should adopt 
the following conventions: 



Certificate Type 


File/Table 
name 


Location 


Source 


Notes 


Merchant encryption 
certificate for a 
merchant named 


<name>.enc 


vPOS only 


CA 


Signed by 
bankroot.crt 
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<name> 










Merchant signature 
certificate for a 
merchant named 
<name> 


<name>.sig 


vPOS only 


CA 


Signed by 
bankroot.crt 


Gateway signature 
certificate 


gateway, enc 


vPOS and 
vGATE 


CA 


Signed by 
bankroot.crt 


Gateway signature 
certificate 


gateway, sig 


vGATE only 


CA 


Signed by 
bankroot.crt 


Wells Fargo Brand CA 
certificate 


bankroot.crt 


vGATE and 
vPOS 


Installa 
tion 


Signed by CA 
root key 


CA root key 


NOT 

APPLICABLE 


vGATE and 
vPOS 
source 
code (and 
binaries) at 
time of 
build 


Installa 
tion 


not signed 



SECURITY NOTE: 

If a hacker breaks into a merchant's site, many security compromises are 
possible. It is not clear how many measures we can take to prevent 

5 malfeasance once the site is compromised. One attack that is possible in 
this situation is to replace components of the certificate hierarchy so that 
the merchant is sending data (securely) to a recipient who is not the bank. 
This is the reason we have the CA root key hard-wired into the software. In 
order for this attack to succeed, the attacker must alter the vPOS 

10 executable. It is my-position-that-this is the most we can reasonablydo 

(short of hardware crypto.) 

£H3 
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KEY IGNITION 

Key ignition is the process of decrypting sensitive keying material and 
loading it into a process space. Both vPOS and vGATE will require two 
private components to be loaded into memory via this key ignition 
procedure. Both vPOS and vGATE have a persistent process which either 
calls down onto PCL or spawns a process which calls down onto PCL. In 
this process, three global variables should be defined: 

unsigned char sz_password[MAXPASSWORDLEN]; 
CPCLKey *SigPrivComp=NULL; 
CPCLKey *EncPrivComp=NULL; 

Shortly after the persistent process boots up, the password should be 
passed into the process (via a UI prompt) and assigned to the sz_password 
variable. Before processing any transactions, the persistent process should 
execute the following code fragment precisely once: 

int sig_retval, enc_retval; 

//Caller is responsible for deleting SigPrivComp and 
EncPrivComp 

sigjretval = IgniteSigKey(&SigPrivComp, sz_password); 
enc_retval = IgniteEncKey(&EncPrivComp, sz_password); 
memset(sz_password, NULL, MAXPASSWORDLEN); 
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It should be obvious from context that the implementation of IgniteSigKey 
and IgniteEncKey are implementable using constructors for CPCLKey and 
the routine FetchPrivateComponent mentioned above. The return values 
must be checked, if non-zero the caller must report the failure and shut 
5 down the process. Failure modes include: failure to find file, failure to read 
file, failure to decrypt data, and wrong password. 



While various embodiments have been described above, it should be 
10 understood that they have been presented by way of example only, and not 
limitation. Thus, the breadth and scope of a preferred embodiment should 
not be limited by any of the above described exemplary embodiments, but 
should be defined only in accordance with the following claims and their 
equivalents. 
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CLAIMS 

What is claimed is: 



1 1 . A method 4or certifying a parly in communication with a first application 

2 resident on a first computer, said first computer in communication with 

3 a second computer with a certification authority resident thereon, said 

4 first and second computers coupled by a network, comprising the steps 

5 of: 

6 (a) creating a name-value pair for certification processing on said first 

7 computer; 

8 (b) transmitting a message containing the name-value pair to an appropriate 

9 certification authority on said second computer; 

10 (c) transmitting other certification information, including identity 

1 1 information, from said first computer to said certification authority on 

12 said second computer; and 

13 (d) creating a certificate comprising said name-value pair and said other 

14 certification information by said certification authority on the second 

15 computer. 

1 2. The method as recited in claim 1, in which the certification information is 

2 formatted in conformance with PKCS- 10. 

1 3. The method as recited in claim 1, wherein a browser is used to transmit 

2 and receive messages from the network. 

1 4. The method as recited in claim 1, including the step of storing the name- 

2 value pair in a secure storage at said first computer. 
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1 5. The method as recited in claim 1, including the step of transmitting the 

2 certificate to said application resident on said first computer utilizing the 

3 network. 

1 6. The method as recited in claim 1, wherein the network is a public 

2 network. 

1 7. The method as recited in claim 1, including the step of storing 

2 certification authority rules at the second computer and tailoring said 

3 certification authority rules based on said certification information 

4 transmitted by said administrative function resident on said third 

5 computer. 
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1 8. Apparatus for certifying a party in communication with a first 

2 application resident on a first computer, said first computer in 

3 communication with a second computer with a certification authority 

4 resident thereon, said second computer in communication with a third 

5 computer utilizing an administrative function resident thereon, said first, 

6 second and third computers connected by a network, comprising: 

7 (a) first computer software that is resident in said first computer and creates 

8 a name-value pair for certification processing on said first computer; 

9 (b) third computer software that is resident in said third computer and 

10 transmits the name-value pair to said administrative function on said 

1 1 third computer for routing to the appropriate certification authority on 

12 said second computer; 

13 (c) fourth computer software that is resident in said third computer and 

14 transmits other certification information from said administrative 

15 function to said certification authority on said second computer; and 

16 (d) fifth computer software that is resident in said second computer and 

17 creates a certificate comprising said name-value pair and said other 

1 8 certification information by said certification authority on the second 

19 computer. 

1 9. The apparatus as recited in claim 8, in which the certification 

2 information is formatted in conformance with PKCS- 10. 

1 10. The apparatus as recited in claim 8, wherein a browser is used to 

2 transmit and receive messages from the network. 

1 _____ J. 1 . The apparatus as recited in c laim 8 , including a storage in which the 

2 name-value pair is securely deposited at said first computer. 
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1 12. The apparatus as recited in claim 8, including communication software 

2 that transmits the certificate to said application resident on said first 

3 computer utilizing the network. 

1 13. The apparatus as recited in claim 8, wherein the network is a public 

2 network. 

1 14. The apparatus as recited in claim 8, including certification authority 

2 rules stored at the second computer and tailored based on said 

3 certification information transmitted by said administrative function 

4 resident on said third computer. 
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1 15. A computer program embodied on a computer-readable for certifying a 

2 party in communication with a first application resident on a first 

3 computer,-said first computer in communication with a second computer 

4 with a certification authority resident thereon, said second computer in 

5 communication with a third computer utilizing an administrative 

6 function resident thereon, said first, second and third computers 

7 connected by a network, comprising: 

8 (a) first computer software that is resident in said first computer and creates 

9 a name-value pair for certification processing on said first computer; 

10 (b) third computer software that is resident in said third computer and 

1 1 transmits the name-value pair to said administrative function on said 

12 third computer for routing to the appropriate certification authority on 

13 said second computer; 

14 (c) fourth computer software that is resident in said third computer and 

15 transmits other certification information from said administrative 

16 function to said certification authority on said second computer; and 

17 (d) fifth computer software that is resident in said second computer and 

18 creates a certificate comprising said name-value pair and said other 

19 certification information by said certification authority on the second 

20 computer. 

1 16. The computer program as recited in claim 15, in which the certification 

2 information is formatted in conformance with PKCS-10. 

1 17. The computer program as recited in claim 15, wherein a browser is used 

2 to transmit and receive messages from the network. 
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1 18. The computer program as recited in claim 15, including a storage in 

2 which the name-value pair is securely deposited at said first computer. 

1 19. The computer program as recited in claim 15, including communication 

2 software that transmits the certificate to said application resident on said 

3 first computer utilizing the network. 

1 . 20. The computer program as recited in claim 15, wherein the network is a 

2 public network. 

1 21. The computer program as recited in claim 15, including certification 

2 authority rules stored at the second computer and tailored based on said 

3 certification information transmitted by said administrative function 

4 resident on said third computer. 
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Terminal Totals Report 

Note: The transaction is not currently implemented. The report below is a sample. 
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